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Preface 


This manual is a guide for users of Adaptec's SDS-310F SCSI Bus 
Analyzer. It is assumed that the reader is already familiar with basic 
SCSI concepts (commands and phases) and basic logic analyzer 
concepts (data capture and data display). 

This manual contains four chapters and two appendices organized as 
follows: 

Chapter 1, Installation, is a tutorial chapter that details proper instal¬ 
lation of the analyzer hardware and software. Please follow the 
documented procedures to ensure correct and safe operation of the 
analyzer. 

Chapter 2, Key Concepts, is a tutorial chapter on the concepts that 
must be understood for effective use of the analyzer. This analyzer 
has significant differences from traditional logic analyzers. Even if 
you have extensive experience with logic analyzers, you will need to 
study the information in this chapter to use your analyzer to full 
effect. 

Chapter 3, Interactive Menu, provides a reference for the analyzer's 
interactive user interface. The menu interface is designed to be 
intuitive, including context sensitive on-line help. In addition to 
providing interactive menu interface details, this chapter also pro¬ 
vides important information on invoking the menu. 

Chapter 4, Rim Time Function Library, provides a reference for the 
analyzer's C Programming Language programmer's interface. This 
chapter describes the procedures for performing SCSI bus analysis 
from a 'C' program. Detailed descriptions of each function are pro¬ 
vided. 

Appendix A, Troubleshooting, provides a guide to correcting com¬ 
mon problems with the analyzer. 

Appendix B, Specifications, contains detailed electrical, timing, 
environmental, and physical specifications of the analyzer. 
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C h a p t e r 



Installation 



In addition to this manual, the SDS-310F SCSI bus analyzer comes 
standard with the following components: 

1. Analyzer printed circuit board (PCB). A PC/AT 16-bit form-factor 
PCB that performs single-ended SCSI bus analysis. If you pur¬ 
chased your analyzer in a turnkey configuration, this PCB will be 
shipped to you already installed in a computer. If you purchased 
your analyzer in an integration kit configuration, you must install 
this PCB in your own computer. 

2. Terminating resistors. Four 10-pin single in-line package (SIP) 
resistor packs that are used to terminate the analyzer PCB's 68-pin 
connector for applications where the analyzer is connected to a 
physical end of tire SCSI bus cable. 

3. SCSI 'P' connector translator. A translator that is used to connect an 
8-bit 50-pin single-ended SCSI 'A'-type bus to the analyzer PCB's 
standard 68-pin SCSI T' connector. 

4. External probe pod. A pod with: 

• Four input wires that can be connected to non-SCSI signals for 
acquisition and triggering by the analyzer. 

• One output wire that will assert itself whenever the analyzer 
triggers. 

• One wire to attach to ground. 

• One 10-pin flat ribbon cable to connect the pod to the analyzer. 

5. Internal Connection Cable. A 50-pin flat ribbon cable used to 
connect the analyzer PCB to a test adapter or differential adapter 
PCB inside the computer. 

6. Interactive menu diskettes. Found in the back of this manual. 

7. Run time function library diskettes. Found in the back of this 
manual. 

These components together with a PC-compatible computer are every¬ 
thing you need to perform passive 20 nanosecond resolution, 8- or 16-bit 
single-ended SCSI bus analysis. 

You can also perform passive 8- or 16-bit differential SCSI bus analysis 
with the above components if you add an optional SDS-311F SCSI 
differential adapter. You can also perform concurrent 8-bit SCSI bus 
emulations with the above components if you add an optional SDS- 
3F SCSI test adapter. 
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NOTE 




V. 


For more information on Adaptec's SDS-311F differential 
adapter and SDS-3F test adapter product offerings, contact 
your local Adaptec sales representative. 


There are several configurations of the analyzer hardware de¬ 
pending on: 

1. The type of SCSI bus you are analyzing. 

2. If you want to perform simultaneous SCSI bus emulations. 

3. If you want to include non-SCSI signals in your analysis. 

The installation of each configuration consists of three steps: 

1. Installing the appropriate PCB components inside the computer. 

2. Connecting the SCSI bus to the computer. 

3. Connecting the external probe pod to the analyzer (Optional). 


The SDS-310F SCSI bus analyzer is shipped in one of two basic 
configurations: turnkey or integration kit. In the turnkey configura¬ 
tion, all PCBs have been shipped to you already installed in the 
Adaptec-supplied computer. If you purchased a turnkey configura¬ 
tion, you can skip ahead to the Connecting the SCSI Bus section of 
this chapter. 

In the integration kit configuration, you must install the appropriate 
PCB(s) in your computer by following the procedures detailed in the 
following subsections. 

The minimum computer requirements are: 

• PC/AT-compatible. 

• CG A video controller. 

• i286 CPU. 

• 640 KBytes RAM. 

• 1.2 MByte 5 1 /4" or 1.44 MByte 31/2" floppy drive. 

• Hard chive with at least 1 MByte available. 

• 1,2, or 3 free backplane slots (two 16-bit, one 8- or 16-bit), 
depending on your configuration. 
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• One of the following hexadecimal PC I/O address ranges 
available: 

310-31F, 330-33F, 360-36F, 380-38F. 

r\ a 

• LA^O 3.U. 

After you have installed the appropriate PCBs inside your computer 
with the appropriate I/O addressing, SCSI bus termination, and 
internal connections, you may close your computer. All further 
configuration will be performed outside of the computer. Whatever 
type of SCSI bus you are analyzing, you can configure the analyzer, 
differential adapter, and test adapter for that bus without re-opening 
the computer, as explained in the Connecting the SCSI Bus section 
of this chapter. 

Installing the Analyzer PCB 

1. If you are installing the analyzer PCB as the only hardware 

option in your computer (no test adapter, differential adapter, or 
other vendors 7 PCBs), skip ahead to Step 2. 

If you are installing other hardware options, check their I/O 
addressing requirements. If there is a conflict with the analyzer 
PCB 7 s pre-set address range of 310-31F, you must resolve this 
conflict before installing the analyzer PCB. To change the ad¬ 
dress of the analyzer PCB, select the desired address with dual 
in-line package (DIP) switches 1 and 2 on the analyzer PCB as 
follows: 


1 

2 

I/O Address Range 

OFF 

ON 

310-31F* 

ON 

OFF 

330-33F 

OFF 

OFF 

360-36F 

ON 

ON 

380-38F 


'Factory setting. 


DIP switches 3 and 4 are reserved and should be left OFF. 

2. If you are connecting the analyzer to a physical end of the SCSI 
bus cable, install the four 10-pin terminating resistor SIP's into 
sockets RP2, RP3, RP4, and RP5. If you are connecting the 
analyzer to the middle of the cable, remove them. Never remove 
the 6-pin resistor SIP in socket RP1. 
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Try to be consistent with your termination requirements. 

Each time you change termination requirements (by 
moving the analyzer to or from a physical end of the SCSI 
cable) you will need to re-open your computer to install or 
remove these resistors. 


3. Install the analyzer PCB in your computer's backplane. See your 
computer's documentation for instructions on installing hard¬ 
ware option PCBs. Make sure that you install the analyzer PCB 
into a PC/AT-compatible backplane slot. Also make sure that 
the 68-pin T' SCSI connector can be easily accessed from the 
outside of the computer. Lastly, make sure the PCB is securely 
attached to the computer to minimize the chance of malfunction 
or damage. 

See Figure 1-1. 



Figure 1-1. 

Installing the Analyzer PCB 
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Adding Only a Differential Adapter PCB 

To analyze a differential SCSI bus, you will need to install an SDS- 
31IF differential adapter PCB. You should install the differential 
adapter PCB in a backplane slot adjacent to the analyzer PCB. The 
differential adapter PCB only requires a PC/XT-compatible slot, but 
it will also function properly in a PC/AT-compatible slot. You will 
need to connect the analyzer and differential adapter PCBs with a 
cable provided with the differential adapter. See the differential 
adapter user's manual for details on its installation. 

See Figure 2-2. 



Figure 1-2. 

Adding a Differential Adapter PCB 


r 


NOTE 


The SDS-310F will function correctly with the older model SDS- 
311 differential adapter. The only difference will he that differen¬ 
tial analysis will he restricted to 8-hit 'A' cable SCSI buses. It is 
recommended that you purchase an SDS-311F to replace your 


[SDS-311. 


j 
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Adding Only a Test Adapter PCB 


To perform simultaneous SCSI bus emulation and analysis with the 
same computer, you will need to install an SDS-3F test adapter PCB. 
See the test adapter user's manual for details on its installation. 

Once the test adapter PCB is installed in the computer, there are two 
possible cabling configurations. 

In the first configuration, the two PCBs operate independent of each 
other. Each connects to the SCSI bus through its own external SCSI 
bus connector. In this case, there are no internal connections be¬ 
tween the two PCBs. You may install the test adapter PCB in any 
backplane slot, not just a slot adjacent to the analyzer PCB. 

See Figure 1-3. 



Figure 1-3. 

Adding a Test Adapter PCB — First Configuration 
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In the second configuration, the analyzer PCB is connected internally 
to the test adapter PCB using the internal connection cable included 
with your analyzer, and the SCSI bus is connected only to the test 
adapter runs external dcjdi dus connector, m this case, the test 
adapter PCB should be installed in a backplane slot adjacent to the 
analyzer PCB. 

See Figure 1-4. 



Figure 1-4. 

Adding a Differential Adapter PCB — Second Configuration 


The configuration you choose depends on your application. The 
first has the advantage that it allows analysis of 8 or 16-bit SCSI 
buses, even though the test adapter is limited to 8-bit emulations. 
The second configuration has the advantage that is only requires one 
connection to the SCSI bus. If all analysis will be performed on 8-bit 
SCSI buses, the second configuration is recommended. 
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Adding Both Differential Adapter and Test Adapter PCBs 


For simultaneous analysis and emulation of differential SCSI buses, 

you will need to install both an SDS-3F test adapter PCB and an SDS- 

31 IF differential adapter PCB. 

1. Install the differential adapter PCB as described in the differen¬ 
tial adapter user's manual. Use a backplane slot adjacent to the 
analyzer PCB. 

2. Install the test adapter PCB as described in the test adapter user's 
manual. Use a backplane slot adjacent to the differential adapter 
PCB. 

3. Connect the differential adapter PCB to the test adapter and 
analyzer PCBs with the cables provided with your differential 
adapter. 

See Figure 1-5. 



Figure 1-5. 

Adding Both Differential Adapter and Test Adapter PCBs 
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Connecting the 
SCSI Bus 


NOTE 

Before following the procedures in this section, make sure 
the appropriate PCBs have been installed in your computer. 
See the Installing PCB Components section of this 
chapter for details . 


There are 13 possible configurations when connecting a SCSI bus to 
your computer depending on the PCBs that are installed and the 
type of SCSI bus that is being connected. To find your configuration, 
use the following table: 


AnalyzerPCB 

Installed? 

Diff. Adapter 
PCB Installed? 

Test Adapter 
PCB Installed? 

SCSI Bus 
Width 

SCSI Bus 
Type 

Config. 

Number 

Yes 

No 

No 

8 

SE 1 

1 

Yes 

No 

No 

16 

SE 

2 

Yes 

Yes 

No 

8 

SE 

3 

Yes 

Yes 

No 

16 

SE 

4 

Yes 

Yes 

No 

8 

Diff 

5 

Yes 

Yes 

No 

16 

Diff 

6 2 

Yes 

No 

Yes 3 

8 

SE 

7 

Yes 

No 

Yes 3 

16 

SE 

8 

Yes 

No 

Yes 4 

8 

SE 

9 

Yes 

Yes 

Yes 

8 

SE 

10 

Yes 

Yes 

Yes 

16 

SE 

11 

Yes 

Yes 

Yes 

8 

Diff 

12 

Yes 

Yes 

Yes 

16 

Diff 

13 2 


’SE = Single-ended. 

2 Not supported with SDS-311. Must use SDS-311F. 

3 Test adapter PCB and analyzer PCB not connected internally. 
4 Test adapter PCB connected internally to analyzer PCB. 


The procedures for installing these configurations are detailed in the 
following subsections. 


r 


NOTE 




For all 13 configurations , it is assumed that proper termi¬ 
nation is already set for your SCSI connector. See Step 2 
in the Installing the Analyzer PCB section of this 
chapter for details. 


J 
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Only the Analyzer PCB Installed 

Configuration 1: 8-bit Single-Ended 'A' Cable SCSI Analysis 

1. On the SCSI T' connector translator, turn switch 5 "ON'. If the 
analyzer PCB's 68-pin T' connector is terminated, turn switches 
1-4 'ON'; otherwise, turn them 'OFF'. 

2. Plug the translator into the analyzer PCB's 68-pin T' connector. 

3. Plug the SCSI bus cable into the translator's 50-pin 'A' connector. 
See Figure 1-6. 



Figure 1-6. Configuration!. 
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Configuration 2: 16-bit Single-Ended 'P' Cable SCSI Analysis 

Plug the SCSI bus cable into the analyzer PCB's 68-pin T' connector. 

See Figure 1-7. 



Figure 1-7. Configuration 2. 
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Only the Analyzer and Differential Adapter PCBs Installed 

Configuration 3: 8-bit Single-Ended 'A' Cable SCSI Analysis 

1. Unplug any SCSI bus cable or connector translator from the 
differential adapter PCB's 68-pin T' connector. 

2. Disable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

3. On the SCSI T' connector translator, turn switch 5 'ON'. If the 
analyzer PCB's 68-pin T' connector is terminated, turn switches 
1-4 'ON'; otherwise, turn them 'OFF'. 

4. Plug the translator into the analyzer PCB's 68-pin T' connector. 

5. Plug the SCSI bus cable into the translator's 50-pin 'A' connector. 

See Figure 1-8. 



Figure 1-8. Configurations. 


12 : 
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Configuration 4: 16-bit Single-Ended '?’ Cable SCSI Analysis 


1. Unplug any SCSI bus cable or connector translator from the 
differential adapter PCB / s 68-pin / P / connector. 

2. Disable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

3. Plug the SCSI bus cable into the analyzer PCB's 68-pin T' con¬ 
nector. 

See Figure 1-9. 


ANALYZER PCB 
BRACKET 


68-PIN V 
CONNECTOR 



SCSI BUS CABLE 


DIFFERENTIAL ADAPTER 
PCB BRACKET 


SET SWITCH TO DISABLE 
DIFFERENTIAL ADAPTER 
(SDS-311F ONLY) 


Figure 1-9. Configuration 4. 
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Configuration 5: 8-bit Differential 'A' Cable SCSI Analysis 

1. Unplug any SCSI bus cable or connector translator from the 
analyzer PCB's 68-pin T' connector. 

2. Enable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

3. On the SCSI T' connector translator, turn switch 5 'OFF'. If the 
differential adapter PCB's 68-pin T' connector is terminated, 
turn switches 1-4 'ON'; otherwise, turn them 'OFF'. 

4. Plug the translator into the differential adapter PCB's 68-pin T' 
connector. 

5. Plug the SCSI bus cable into the translator's 50-pin 'A' connector. 

See Figure 1-10. 



r 


NOTE 




| If you are using an SDS-311 , the 50-pin SCSI A' cable will plug directly j 
\{nto the differential adapter PCB. Do not use a 'P' connector translator. J 


14 SDS-310F 
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Configuration 6: 16-bit Differential'?' Cable SCSI Analysis 

1. Unplug any SCSI bus cable or connector translator from the 
analyzer PCB's 68-pin T' connector. 

2. Enable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

3. Plug the SCSI bus cable into the differential adapter PCB's 68-pin 
T' connector. 

See Figure 1-11. 


ANALYZER PCB 
BRACKET 




Figure 1-11. Configuration 6. 
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Only the Analyzer and Test Adapter PCBs Installed 


Configuration 7: 8-bit Single-Ended. 'A' Cable SCSI Analysis and 
Optional Emulation 


^ NOTE 

For simultaneous analysis and emulation, this configura¬ 
tion requires two 50-pin SCSI bus cable connections. 


1. On the SCSI T' connector translator, turn switch 5 "ON 7 . If the 
analyzer PCB's 68-pin T' connector is terminated, turn switches 
1-4 "ON 7 ; otherwise, turn them 7 OFF 7 . 


2. Plug the translator into the analyzer PCB's 68-pin T 7 connector. 

3. Plug the SCSI bus cable into the translator's 50-pin 'A' connector. 

4. Plug the SCSI bus cable into the test adapter PCB's 50-pin 7 A 7 
connector (Optional). 

See Figure 1-12. 



Figure 1-12. Configuration 7. 
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Configuration 8: 16-bit Single-Ended 'P' Cable SCSI Analysis and 
Optional 8-bit Single-Ended 'A' Cable SCSI Emulation 


In this case, the analyzer can perform 16-bit analysis, but 
the test adapter can only perform 8-bit emulation. Also, for 
simultaneous analysis and emulation, this configuration 
requires two SCSI bus cable connections: one 68-pin and 
one 50-pin. 


1. Plug the SCSI bus cable into the analyzer PCB's 68-pin T' con¬ 
nector. 

2. Plug the SCSI bus cable into the test adapter PCB's 50-pin 'A' 
connector (Optional). 

See Figure 1-13. 


ANALYZER PCB 
BRACKET 


68-PIN V 
CONNECTOR 


SCSI BUS CABLE 


TEST ADAPTER 
PCB BRACKET 


50-PIN A‘ 
CONNECTOR 


SCSI BUS CABLE 
(OPTIONAL) 


Figure 1-13. Configuration 8. 
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Configuration 9: 8-bit Single-Ended 'A' Cable SCSI Analysis and 
Optional Emulation 

Plug the SCSI bus cable into the test adapter PCB's 50-pin 'A' con¬ 
nector. 

See Figure 1-14. 


ANALYZER PCB 
BRACKET 


68-PIN 'P 
CONNECTOR 



TEST ADAPTER 
PCB BRACKET 


50-PIN 'A' 
CONNECTOR 



SCSI BUS CABLE 


Figure 1-14. Configuration 9. 
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Analyzer, Differential Adapter, and Test Adapter PCBs Installed 

Configuration 10: 8-bit Single-Ended 'A' Cable SCSI Analysis and 

Emulation 

1. Unplug any SCSI bus cable or connector translator from the 
differential adapter PCB's 68-pin T' connector. 

2. Enable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

3. Plug the SCSI bus cable into the test adapter PCB's 50-pin 'A' 
connector. 

See Figure 1-15. 


ANALYZER PCB 
BRACKET 


68-PIN ‘P 
CONNECTOR 



TEST ADAPTER 
PCB BRACKET 



DIFFERENTIAL 
ADAPTER 
PCB BRACKET 


SET SWITCH TO 

ENABLE 

DIFFERENTIAL 

ADAPTER 

(SDS-311FONLY) 



Figure 1-15. Configuration 10. 
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Configuration 11: 16-bit Single-Ended 'P' Cable SCSI Analysis and 
Optional 8-bit Single-Ended 'A' Cable SCSI Emulation 


r 


NOTE 




In this case, the analyzer can perform 16-bit analysis, but the 
test adapter can only perform 8-bit emulation. Also, for simulta¬ 
neous analysis and emulation, this configuration requires two 
SCSI bus cable connections: one 68-pin and one 50-pin. 


j 


1. Unplug any SCSI bus cable or connector translator from the 
differential adapter PCB's 68-pin T' connector. 


2. Disable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 


3. Plug the SCSI bus cable into the analyzer PCB's 68-pin T' con¬ 
nector. 


4. Plug the SCSI bus cable into the test adapter PCB's 50-pin 'A' 
connector (Optional). 

See Figure 1-16. 



Figure 1-16. Configuration 11. 
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Configuration 12: 8-bit Differential 'A' Cable SCSI Analysis and 
Emulation 


1. Unplug any SCSI bus cable or connector translator from the 
analyzer PCB's 68-pin T' connector. 

2. Unplug any SCSI bus cable from the test adapter PCB's SCSI 
connector. 

3. Enable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

4. On the SCSI T' connector translator, turn switch 5 'OFF'. If the 
differential adapter PCB's 68-pin T' connector is terminated, 
turn switches 1-4 'ON'; otherwise, turn them 'OFF'. 

5. Plug the translator into the differential adapter PCB's 68-pin T' 
connector. 

6. Plug the SCSI bus cable into the translator's 50-pin 'A' connector. 

See Figure 1-17. 


ANALYZER PCB 
BRACKET 


DIFFERENTIAL 
ADAPTER 
PCB BRACKET 


ON IF TERMINATED 
OFF OTHERWISE 


68-PIN P' 
CONNECTOR 


TEST ADAPTER 
PCB BRACKET 


SCSI F CONNECTOR 
TRANSLATOR 


SCSI BUS CABLE 


SET SWITCH TO ENABLE 
DIFFERENTIAL ADAPTER 
(SDS-311FONLY) 


Figure 1-17. Configuration 12. 


NOTE 


If you are using an SDS-311, the 50-pin SCSI 'A' cable will plug directly 
into the differential adapter PCB. Do not use a'P' connector translator. 
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Configuration 13: 16-bit Differential 'P' Cable SCSI Analysis and 

8-bit Differential 'A' Cable SCSI Emulation 

^ NOTE ^ 

In this case, the analyzer can perform 16-bit analysis, but 
the test adapter can only perform 8-bit emulation. 

1. Unplug any SCSI bus cable or connector translator from the 
analyzer PCB's 68-pin / F connector. 

2. Unplug any SCSI bus cable from the test adapter PCB's SCSI 
connector. 

3. Enable the differential adapter by choosing the appropriate 
switch setting on the differential adapter PCB's bracket. See the 
differential adapter user's manual for this switch setting. 

4. Plug the SCSI bus cable into the analyzer PCB's 68-pin T' con¬ 
nector. 

See Figure 1-18. 



Figure 1-18. Configuration 13. 

f NOTE 

l 

{ The SDS-311 does not support this configuration. 
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Connecting the External Probe Pod (Optional) 


NOTE 

Before connecting the external probe pod, make sure the 
appropriate PCBs have already been installed in your 
computer. See the Installing PCB Components section 
of this chapter for details. 


If you want to analyze non-SCSI signals along with SCSI signals, you 
will need to install the external probe pod. This pod always con¬ 
nects to the analyzer PCB, even if a differential or test adapter PCB is 
also installed. 


To connect the pod: 

1. Plug one end of the 10-pin flat ribbon cable into the analyzer 
PCB's 10-pin connector. The analyzer connector is keyed to 
prevent plugging the cable in backwards. 

2. Plug the other end of the cable into the pod. The pod connector 
is keyed to prevent plugging the cable in backwards. 

To connect the pod to non-SCSI signals: 

1. Always connect the pod wire labeled GND to signal ground. 

2. If want to acquire or trigger on non-SCSI TTL-class signals, 
connect the pod wires labeled EXT 0, EXT 1, EXT 2, and EXT 3 to 
the desired signals. 

3. If you want to trigger an external device, connect the pod wire 
labeled TOUT to the desired TTL-class input pin. 

See Figure 1-19. 
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I Installing the 
Software 


There are two independent analyzer software modules: the inter¬ 
active menu and the run time function library. You may install 
either or both of these modules depending on your application. For 
more information on these modules, see the Interactive Menu and 
Run Time Function Library chapters of this manual. 


r 


NOTE 




Both modules will be installed into directory 
\SDS\SDS310F. After installation , it is recommended 
that you treat this directory as read only. Do not create 
any user files in this directory or any of its subdirectories. 
This will make the loading of future software revisions 
easier because , prior to loading a new revision , you can 
delete the entire contents of this directory to remove the old 
revision without regard for the files deleted. 


In the turnkey configuration, all software has already been installed 
on hard drive C: of the Adaptec-supplied computer. If you pur¬ 
chased your analyzer in a turnkey configuration, you can skip ahead 
to the The SDS310F Configuration Utility section of this chapter. 


Installing the 
Interactive Menu 


The analyzer interactive menu diskettes are located at the back of 
this manual. Two diskette formats are provided: 5 1 /4" 1.2 MBytes 
and 3 1/2" 1.44 MBytes. 

To install the menu: 


1. Determine the hard drive (C:, D:, etc.) that you want to hold the 
menu files and make that drive current by typing 
specifier< ENTER> where specifier is the drive specifier (C:, D:, 
etc.). 


2. Insert the diskette labeled SDS-310F Bus Analyzer Menu, Disk 1 
in floppy drive A: and type A:LOAD<ENTER>. The installation 
procedure will prompt you for all required information and any 
other diskettes. 


r 


NOTE 



If you need to load from floppy B ;, before typing 
A:LOAD<ENTER>, execute the DOS 
ASSIGN A=B<ENTER> command to map floppy B: logically to 
floppy A:. It is recommended that after the installation is complete 
you re-boot your system to undo the logical assignment. See your 
DOS documentation for details on the ASSIGN command. 
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This installation will load the menu files into subdirectories of 
directory \SDS\SDS310F of the current hard drive. The installed 
files will require approximately 500 KBytes. 

After you have performed this installation, set up your DOS envi¬ 
ronment for analyzer use as described in the The SDS310F Configu¬ 
ration Utility section of this chapter. You will then be able to use 
your analyzer with the interactive menu. See the Interactive Menu 
chapter of this manual for details on invoking and operating the 
menu. 


Installing the Run 
Time Function Library 


The analyzer run time function library is an optional library 
addition to the SDS-3F Development System's SCSI C Library. You 
must install the SCSI C Library before installing the analyzer run 
time function library. See the SCSI C Library user's manual for 
details on its installation. 


NOTE 

For more information on the SDS-3F Development 
System's SCSI C Library, contact your local Adaptec sales 
representative. 


The analyzer run time function library diskettes are located at the 
back of this manual. Two diskette formats are provided: 5 1 /4" 1 2 
MBytes and 31 /2" 1.44 MBytes. 

To install the library: 

1. Determine the hard drive (C:, D:, etc.) that you want to hold the 
library files and make that drive current by typing 

specifier< ENTER> where specifier is the drive specifier (C:, D:, 
etc.). 

2. Insert the diskette labeled SDS-310F Bus Analyzer Run Time 
Function Library, Disk 1 in floppy drive A: and type 
A:LOAD<ENTER>. The installation procedure will prompt you 
for all required information and any other diskettes. 
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NOTE 


If you need to load from floppy B:, before typing 
A:LOAD<ENTER>, execute the DOS 
ASSIGN A=B<ENTER> command to map floppy B: logically to 
floppy A:. It is recommended that after the installation is complete 
you re-boot your system to undo the logical assignment. See your 
DOS documentation for details on the ASSIGN command. 


The SDS310F 
Configuration 
Utility 


This installation will load the library files into subdirectories of directory 
\SDS\SDS310F of the current hard drive. The installed files require 
approximately 500 KBytes. 

After you have performed this installation, set up your DOS environ¬ 
ment for analyzer use as described in the The SDS310F Configuration 
Utility section of this chapter. Assuming you have previously installed 
the SDS-3F Development System's SCSI C Library, you will be able to 
create and execute user tests for the analyzer. See the Rim Time Func¬ 
tion Library chapter of this manual for details on creating and executing 
analyzer user tests. 



NOTE 

Before following the procedures in this section, make sure the 
appropriate hardware and software have been installed on your 
computer. See the Installing the Hardware and Installing 
the Software sections of this chapter for details. 


The interactive menu and run time function library installations both 
copy a utility named SDS310F to the root directory of the current hard 
drive. After you boot your computer and before your first use of the 
analyzer, you must execute this utility to configure the DOS environ¬ 
ment for analyzer use. 

It is recommended that you move the two files SDS310F.BAT and 
SDSENV.EXE from the root to a directory in your DOS PATH for easier 
execution. If your system will be dedicated to analyzer use, you may 
execute SDS310F automatically from your system AUTOEXECBAT 
file. See your DOS documentation for details on PATH and 
AUTOEXECBAT. 

If you installed your analyzer software on hard drive C and did not 
change the 1/O address of your analyzer PCB from the default 310, you 
can configure the DOS environment by simply typing 
SDS310F<ENTER> with no parameters. In this case, you can skip the 
remainder of this section. 
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If you installed your analyzer software on a hard drive other than C: or 
you changed the analyzer I/O address (or both), you must specify pa¬ 
rameters on the SDS310F command line. The remainder of this section 
describes how to specify these parameters. 

SDS310F sets the following DOS environment variables: SBADRV, 
PATH, and SB AADR. See your DOS manual for details on the DOS 
environment. 

SBADRV 

SDS310F creates a DOS environment variable called SBADRV and sets 
its value to the specifier (without a:) of the hard drive containing the 
analyzer files. The default value is G, but if you have loaded the soft¬ 
ware on a different hard drive you must override this value. To do this, 
specify a different drive letter as the first parameter of SDS310F. 

For example, 

SDS310F D<ENTER> 
will set SBADRV to D for hard drive D:. 

PATH 

SDS310F sets the DOS PATH environment variable to reference the 
directory containing the analyzer executable files. (The name of this 
directory is SBADRV:\SDS\SDS310F\BIN, where SBADRV is the 
current value of the SBADRV environment variable.) If the PATH vari¬ 
able already exists when the utility is executed, the name of the analyzer 
executable file directory will be prepended to the current PATH value. 

If the PATH variable does not exist, it will be created with a value equal 
to the analyzer directory only. 

SBAADR 

SDS310F creates a DOS environment variable called SBAADR and sets 
its value to the hexadecimal I/O address of the analyzer PCB. The de¬ 
fault value is 310. If you have changed the address of your analyzer 
PCB, you must specify the new address as the second parameter of 
SDS310F. Valid values for this parameter are 310,330,360, and 380. If 
you specify an address parameter, you must also specify a drive param¬ 
eter, even if you have loaded the software on the default drive, C:. See 
the Installing the Analyzer PCB section of this chapter for details on 
changing the analyzer PCB I/O address. 

For example, 

SDS310F C 330<ENTER> 
will set SBAADR to 330. 
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NOTE 


The 310FDIAG 
Diagnostic Utility 


r 


Before following the procedures in this section, make sure 
the appropriate hardware and software have been installed 
on your computer and your DOS environment has been 
properly configured for analyzer operation. See the In¬ 
stalling the Hardware, Installing the Software, and 
The SDS310F Configuration Utility sections of this 
chapter for detaUs. 




The interactive menu and run time function library installations both 
copy a utility named 310FDIAG to directory \SDS\SDS310F\BIN. 
You can use 310FDIAG to check and report the configurations of 
both the analyzer and the DOS operating environment. 

To run this utility, type 310FDIAG<ENTER>. 310FDIAG reports 
the following: 

1. The directory that will be searched for analyzer files. 

2. The current value of the SBAADR DOS environment variable. 

3. The current analyzer PCB address switch setting. 

4. Whether or not the analyzer PCB is properly configured. 

See the Troubleshooting appendix of this manual if any problems 
are reported by 310FDIAG. 
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C h a p t e r 


Key 

Concepts 



There are two basic steps to using any logic analyzer: 


1. Capture data. 

2. Analyze the captured data. 

The SDS-310F SCSI bus analyzer has SCSI-specific features designed 
into both of these steps to make SCSI bus analysis more efficient and 
effective. This chapter describes the key concepts that must be 
understood to make full use of these SCSI-specific features. 


I Capturing Data SCSI bus activity is generally characterized as short bursts of very 

fast activity interspersed within long periods of little or no activity. 
Signal pulse widths can be as short as 30 nanoseconds; but times 
with no signal pulses can last milliseconds or longer. Effective 
analysis of this behavior requires resolution of less than 30 nanosec¬ 
onds coupled with a means of capturing data over extended time 
spans. 

Traditional logic analyzers typically capture data on each cycle of a 
fixed clock. The resolution and length of the capture data are com¬ 
pletely determined by the clock cycle time. A 20 nanosecond cycle 
time will fill a 32K buffer in 655.36 microseconds [(2 15 • 20)/1000]. 
This is sufficient resolution to capture all SCSI signal pulses but an 
insufficient time span for effective SCSI analysis. 

The SDS-310F SCSI bus analyzer samples the bus with 20 nanosec¬ 
ond resolution, but, unlike traditional logic analyzers, it only pro¬ 
cesses a sample if there has been a transition of at least one signal 
from the last processed sample. Each sample that requires process¬ 
ing is called an event. Each event includes a time stamp so that the 
timing of events can be reproduced with 20 nanosecond resolution. 
This method of data capture is called transition analysis and pro¬ 
vides both the resolution and the time span required for effective 
SCSI analysis. 

You can configure the analyzer to save all events in the capture 
buffer, or you can use special features of the SDS-310F's data capture 
hardware to control what events are actually saved. These features 
are: the acquisition qualifier, the trigger, the ID qualifier, and the 
event filter. 
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The Capture Buffer 
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The following figure shows a functional block diagram of the SDS- 
310Fs data capture hardware. 

See Figure 2-1. 



-► CONTROLS 


Figure 2-1. SDS-310F Data Capture Functional Block Diagram 


Each event saved in the capture buffer includes the state of the 9 
SCSI control signals (BSY, SEL, ATN, REQ, ACK, C/D, I/O, MSG, 
RST), the 16 data lines (D0-D15), the two parity lines (DPO, DPI), the 
four external probe pod input wires (EXTO-3), and a 40-bit time 
stamp. The analyzer's capture buffer has a capacity of 32K events, 
each event consisting of 71 bits [9 + 16 + 2 + 4 + 40]. 

Event time stamps are relative to the time you started the analyzer 
running. The time between any two events in the capture buffer is 
called the delta time. The analyzer software performs delta time 
calculations automatically. 

The time stamp clock will roll over approximately once every 12 
hours. With each rollover, the time stamp of the first event follow¬ 
ing the rollover will be incorrect. Also, the delta time for any two 
events where one precedes a rollover event and the other follows the 
rollover event will also be incorrect. In most analyses, these limita¬ 
tions should not be a concern; 12 hours is a long time, even by SCSI 
standards. 
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The Acquisition 
Qualifier 


Each SCSI command is executed as a sequence of bus phases: 
arbitration, selection, reselection, message out, command, data out, 
data in, status, and message in. Often, you do not need to capture 
the events of every phase type. For example, if you just want to 
analyze who's using the bus without regard for the actual com¬ 
mands that are being executed, you only need to capture the events 
of arbitration, selection, and reselection phases. If you could limit 
data capture to only those events of the desired phase types, you 
could effectively create more capacity in the capture buffer. The 
analyzer's acquisition qualifier gives you this control. 

You specify one of four modes for the acquisition qualifier: 

All State Save the events of all bus phases: arbitration, 

selection, reselection, message out, command, 
data out, data in, status, and message in. 

Arb Sel Save only the events of arbitration, selection, 

and reselection phases. 

Arb Sel Cmd Save only the events of arbitration, selection, 

reselection, and command phases. 


Arb Sel Cmd Stat Save only the events of arbitration, selection, 
reselection, command, and status phases. 


The biggest consumers of the capture buffer are the events of data 
phases. Each SCSI command typically has 10-20 message bytes, 6, 
10, or 12 command bytes, and one status byte; but thousands of data 
bytes or words. Often it is sufficient to capture only a subset of each 
data phase. In addition to phase control, the analyzer's acquisition 
qualifier gives you control over the amount of data to capture. 

The acquisition qualifier's "All State" option is the only option that 
allows capture of data phases, and with this option you also specify: 

1. The offset of the first byte or word in each data phase to save. 


2 . 


The maximum number of consecutive bytes or words in each 
data phase to save. 


r 


NOTE 




Setting the maximum data byte/word count to 0 disables 
the saving of data phases. In this case , the events of all 
non-data phases , including messages, ivill be saved. 


j 
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The Trigger 


When you tell the analyzer to run, it will immediately start saving 
qualified events in the capture buffer. This capture will continue 
until either you stop the analyzer or a trigger occurs. If more than 
32K qualified events occur before the analyzer stops, the capture 
buffer will wrap, and earlier events will be overwritten with more 
recent events. This means that after the buffer fills, you will always 
be able to see the most recent 32K saved events but will lose any 
preceding events. 

If you are interested in analyzing the SCSI bus activity around a 
particular event, and there is the possibility that enough events will 
follow to overwrite the desired data, you will need to use the 
analyzer's trigger to stop event capture before the desired data is 
overwritten. 

You specify one of four modes for the trigger: 

No Trigger Do not trigger. This will guarantee that you will 

always see the the last 32K events, regardless of what 
preceded them. This mode is especially useful if you 
are trying to analyze the events that lead up to a hang 
condition. 

Immediate Trigger as soon as data capture starts. This will 

guarantee that you will always be able to see the first 
32K qualified events regardless of what follows. For 
this mode, the trigger event is always at the beginning 
of the buffer. 

Phase Trigger when a SCSI phase of the specified type is 

detected. Any of the following SCSI phase types may 
be specified: arbitration, selection, reselection, mes¬ 
sage out, command, data out, data in, status, or 
message in. You specify the phase type by name; the 
software automatically specifies the required state of 
the SCSI control signals for the trigger as follows (1 
asserted, 0 deasserted, X any state, P transition from 
deasserted to asserted): 


Phase Type 

BSY 

SEL 

ATN 

REQ ACK 

C/D 

I/O 

MSG RST 

Arbitration 

1 

0 

0 

0 

0 

0 

0 

0 

0 

Selection 

0 

1 

X 

X 

X 

X 

0 

X 

0 

Reselection 

0 

1 

X 

X 

X 

X 

1 

X 

0 

Message Out Byte 

1 

0 

X 

0 

p 

1 

0 

1 

0 

Command Byte 

1 

0 

X 

0 

p 

1 

0 

0 

0 

Data Out Byte 

1 

0 

X 

p 

p 

0 

0 

0 

0 

Data In Byte 

1 

0 

X 

p 

p 

0 

1 

0 

0 

Status Byte 

1 

0 

X 

p 

0 

1 

1 

0 

0 

Message In Byte 

1 

0 

X 

p 

0 

1 

1 

1 

0 
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In addition to the phase type, you also specify the 
required state of the SCSI data lines (D0-D15), SCSI 
parity lines (DP0-DP1), and external probe pod input 
signals (EXTO-3), plus an occurrence count (up to 
4095). 


NOTE 

When specifying the required states of signals for the 
trigger, specify 1 for asserted, 0 for deasserted, and X 
for any state. P is not an option for user specification. 


A trigger occurrence is detected only when the states 
of an event's SCSI bus and external probe pod input 
signals match all of the required states specified for 
the trigger. The analyzer's data capture hardware 
stops running when the number of trigger occur¬ 
rences equals the specified occurrence count. 


Specify Bits This mode is the same as Phase except that you 

specify the required state of each SCSI control signal 
directly (1,0, or X). As with the Phase mode, you also 
specify the required state of the SCSI data, SCSI 
parity, and external probe pod input signals, plus an 
occurrence count (up to 4095). In this mode, any SCSI 
bus state may be specified including illegal states. 

For the Phase and Specify Bits modes, you also specify one of three 
trigger positions in the capture buffer. These positions assume the 
buffer is full. If the buffer is not full, all events and the trigger are in 
the buffer and available for analysis. 

Before Stop the analyzer approximately 30400 events after 

the trigger. This will place 5% of the capture data 
before the trigger and 95% after. 

Stop the analyzer approximately 16000 events after 
the trigger. This will place 50% of the capture data 
before the trigger and 50% after. 

Stop the analyzer approximately 1600 events after the 
trigger. This will place 95% of the capture data before 
the trigger and 5% after. 


Center 


After 
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The ID Qualifier 


SCSI buses have evolved from single initiator, single target con¬ 
figurations to multiple initiator, multiple target configurations. In 
these complex bus configurations, it is often desirable to analyze the 
activities of one SCSI initiator-target combination and ignore the 
activities of all other combinations. The ID qualifier lets you focus 
both the acquisition qualifier and the trigger on particular initiator- 
target combinations. Qualified events will "pass through' to the 
acquisition qualifier and trigger; unqualified events will be sup¬ 
pressed (see Figure 2-1). 

You specify one of four modes for the ID qualifier: 

Off Disabled. 


Let all events of all target and initiator ID combina¬ 
tions 'pass through' to both the trigger and acquisi¬ 
tion qualifier. 


r 


NOTE 






If you do not plan to use the ID qualifier , select mode Off 
and skip ahead to the next section. 




For the remaining three ID qualifier modes, you must specify the 
ID's of the initiator-target combination that you are interested in. 

For both the initiator and target ID's, you specify one of 0 through 7 
or X. Specifying X for the initiator ID allows you to focus on a 
particular target's activity with all initiators. Specifying X for the 
target ID allows you to focus on a particular initiator's activity with 
all targets. 

SCSI commands may disconnect from the SCSI bus to allow other 
commands to execute before the original command reconnects to the 
bus to continue and/ or complete its execution. The first time a 
command connects to the SCSI bus is called a selection. All subse¬ 
quent times that the command reconnects to the bus are called 
reselections. The remaining three ID qualifier modes enable the ID 
qualifier and allow you to focus on command selections, command 
reselections, or both. 

Sel Resel Enabled for selections and reselections. 

All command selections and reselections for the 
specified initiator-target combination will be qualified 
and 'pass through' subject to the trigger and acquisi¬ 
tion qualification options described below. All other 
selections and reselections will be suppressed. 
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Sel 


Enabled for selections only. 

All command selections for the specified initiator- 
target combination will be qualified and "pass 
through' subject to the trigger and acquisition qualifi¬ 
cations options described below. All other selections 
and reselections, including reselections for the speci¬ 
fied initiator-target combination, will be suppressed. 

Resel Enabled for reselections only. 

All command reselections for the specified initiator- 
target combination will be qualified and 'pass 
through' subject to the trigger and acquisition qualifi¬ 
cation options described below. All other selections 
and reselections, including selections for the specified 
initiator-target combination, will be suppressed. 

If you select one of the above three modes, you also specify one of 
the following options for both the trigger and the acquisition quali¬ 
fier (a different option may be chosen for the trigger and acquisition 
qualifier): 

Off Disabled. 


Let all events of all target and initiator ID combina¬ 
tions pass through to the trigger or acquisition quali¬ 
fier. 



The remaining two options enable the ID qualifier for the acquisition 
qualifier. They also allow you to specify whether you want to 
capture the events of arbitration, selection, or reselection phases. 

In order to make qualifications based on initiator-target ID combina¬ 
tions, the analyzer must inspect all arbitration, selection, and 
reselection phases. The decision of whether or not to save the events 
of these phases cannot be made as these phases are being inspected. 
Instead, you make the decision by specifying one of the following 
options: 
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Allow 


Enabled without arbitration-selection-reselection 
suppression. 


The Event Filter 
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Only let events of the specified initiator ID-target ID 
combination pass through to the acquisition qualifier. 
With this option, the events of arbitration, selection, 
and reselection phases of all initiator-target combina¬ 
tions will pass through, including those for other than 
the specified initiator-target combination. 

Suppress Enabled with arbitration-selection-reselection sup¬ 
pression. 

Only let events of the specified initiator ID-target ID 
combination pass through to the acquisition qualifier. 
With this option, no events of arbitration, selection, or 
reselection phases of any initiator-target combination 
will pass through, even for the specified initiator- 
target combination. This effectively limits events to 
those of information transfer phases. 


If you are performing analysis of an 8-bit bus, the event filter gives 
you the ability to suppress events that contain only transitions of the 
upper 8 data bits of the SCSI bus. In theory, these transitions should 
not occur, but may arise as a result of special environmental condi¬ 
tion. For this option of the event filter, you specify one of the follow¬ 
ing two bus widths: 

8 The SCSI bus is 8-bits wide. Suppress all events that contain 
only transitions of the upper 8 SCSI data bits D8 to D15 or DPI. 

16 The SCSI bus is 16-bits wide. Do not perform any suppression 
based on the upper 8 SCSI data bits D8 to D15 or DPI. 

During information transfers on the SCSI bus, initiators and targets 
qualify each byte or word with the transition of either REQ (when 
the SCSI I/O signal is 1) or ACK (when I/O is 0) from deasserted to 
asserted. Often, the SCSI data lines will go through transitions with 
no qualifying transitions of REQ or ACK. Ordinarily, these unquali¬ 
fied transitions will generate events to be processed by the analyzer. 
Often, these transitions are of no interest to the analysis. The event 
filter also gives you the control over these transitions. 
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You specify one of three modes for the event filter: 

Off All signal transitions (SCSI control, SCSI data, 

SCSI parity, and external probe pod input) 
generate events. 

Transitions of the SCSI data and parity signals 
by themselves will not generate events. Only 
transitions of the 9 SCSI control and four exter¬ 
nal probe pod input signals will generate 
events. 

This mode limits each information transfer to at 
most 4 events: REQ assert, REQ deassert, ACK 
assert, and ACK deassert. 

NOTE 

In the Four Events Per Transfer mode, you can still 
determine the values of SCSI information bytes and words. 

If I/O is 1, they are valid with REQ assertion. If I/O is 0 , 
they are valid with ACK assertion. 


One Event Transitions of the SCSI data and parity signals 

Per Transfer by themselves will not generate events. Transi¬ 

tions of any of the following 7 SCSI control 
signals will generate events: BUSY, SEL, ATN, 
C/D, I/O, MSG, and RST. In addition, if I/O is 
1, a transition of REQ from deasserted to as¬ 
serted will generate an event If I/O is 0, a 
transition of ACK from deasserted to asserted 
will generate an event. Any other transitions of 
REQ or ACK will be suppressed. 

This mode limits each information transfer to 1 
event: REQ asserted or ACK asserted, depend¬ 
ing on when the data is valid. The information 
byte or word saved with this event will be 
valid. 

NOTE > 

Selecting this mode, while minimizing capture data, limits other 
features of the analyzer. Triggering in the Phase mode is restricted 
to arbitration, selection, and reselection. The six predefined infor¬ 
mation transfer triggers will not be detected. Also, capture data 
analysis (see the next section) is limited to timing mode. State 

mode displays will be incorrect. , 




Four Events 
Per Transfer 
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I Analyzing the 
Captured Data 


The SDS-310F software supports two modes for analyzing the 
captured data: state mode and timing mode. In state mode, the 
analyzer software automatically translates the captured data into 
SCSI terms. Figure 2-2 (at the end of this section) shows a SCSI reset, 
test unit ready command, request sense command, and read data 
command sequence displayed in the state mode. 

While state mode simplifies analysis of SCSI phase transitions, 
specific signal transition details are suppressed. 

In timing mode, the captured data is presented as events without 
interpretation exactly as they were captured. Figure 2-3 shows 
captured data of a subset of Figure 2-2's SCSI activity displayed in 
the timing mode. 

In timing mode, you can analyze individual signal transitions with 
20 nanosecond resolution. If you need the detail, this is important. 
Note, however, that more lines are required to display this detail. In 
fact. Figures 2-2 and 2-3 have the same number of display lines. 
However, the timing display only shows activity up to the transfer 
of the third command byte of the test unit ready command. 

You choose the data analysis mode after the data has been captured, 
and you can move back and forth between state and timing modes 
with the same captured data as your analysis requires. 
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State Mode 


State mode data is presented as a sequence of state lines, and each 
line consists of three parts (left to right): 

Time stamp Each state mode line includes a time stamp with 
20 nanosecond resolution. 

SCSI state The state of the SCSI bus for that line interpreted 

as follows: 


State 

Interpretation 

Bus Free 

The SCSI bus is idle. 

Arb Start 

At least one device is arbitrating for the bus. 

Arb Win 

A device has won arbitration. 

Sel Start 

A device is selecting another device. 

Sel End 

A device has selected another device. 

Sel TO 

Selection time out. 

Resel Start 

A device is reselecting another device. 

Resel End 

A device has reselected another device. 

Resel TO 

Reselection time out. 

Msg Out 

Message out information byte transfer(s). 

Command 

Command information byte transfer(s). 

Data Out 

Data out information byte or word transfer(s). 

Data In 

Data in information byte or word transfer(s). 

Status 

Status information byte transfer(s). 

Msg In 

Message in information byte transfer(s). 

(Atn Assertion) 

ATN changed from deassert to assert. 

(Atn Deassert) 

ATN changed from assert to deassert. 

(Rst Assertion) 

RST changed from deassert to assert. 

(Rst Deassert) 

RST changed from assert to deassert. 

Trigger 

The trigger event. 


Lines of the following state types include a nu¬ 
meric field: 

State 

Numeric Field 

Arb Start 

ID’s on the SCSI bus. 

Arb Win 

ID’s on the SCSI bus. 

Sel Start 

ID’s on the SCSI bus. 

Resel Start 

ID’s on the SCSI bus. 

Msg Out 

Message out transfer byte(s). 

Command 

Command transfer byte(s). 

Data Out 

Data out transfer byte(s)/word(s). 

Data In 

Data in transfer byte(s)/word(s). 

Status 

Status transfer byte(s). 

Msg In 

Message in transfer byte(s). 
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Each line of information transfer phases includes 
up to six transfers. If an information transfer 
phase has more than six transfers, that phase will 
generate multiple state mode lines with up to six 
transfers per line. 

If any state line includes the assertion of the SCSI 
ATN or RST signals, an A or R, respectively, will 
be displayed to the right of the state description. 

Lastly, an ambiguous State will have an asterisk 
(*) to the far right. 

Line number The number of the state mode line. Lines are 
numbered sequentially starting with 0. 

Timing Mode 

Timing mode data is presented as a sequence of events, and each 
event consists of three parts (left to right): 

Time stamp Each timing mode line includes a time stamp with 
20 nanosecond resolution. 

Signal states The state of the 9 SCSI control signals (BSY, SEL, 
ATN, REQ, ACK, C/D, I/O, MSG, RST), the SCSI 
data and parity lines, and the four external probe 
pod input signals (EXT0-3). 

Line number The number of the event in the capture buffer. 

Lines are numbered sequentially starting with 0. 

Time Stamps There are two choices for time stamps: real time and delta time. 

Real time time stamps give the elapsed time between the start of the 
analyzer data capture and the time stamped event. These are the 
actual time stamps saved with the events during data capture. The 
format is sss.mmm_uuu_nnn where sss is seconds, mmm is millisec¬ 
onds, uuu is microseconds, and nnn is nanoseconds. The time 
stamps in Figures 2-2 and 2-3 are real time. 

Delta time time stamps give the elapsed time between the immedi¬ 
ately preceding event and the time stamped event. In this case, the 
saved time stamps of two successive events are subtracted. The 
format is the same as for real time time stamps except that leading 
zeros are suppressed. The time stamps in Figure 2-4 are delta time. 
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Data Phases 


Displaying Capture 
Data 


You choose the time stamp display after the data has been captured, and 
you can move back and forth between real time and delta time displays 
with the same captured data as your analysis requires. 


r 


NOTE 


"\ 


V. 


In state mode, the time stamp for any line is the time stamp 
of the first event of that state line. For example, the time 
stamp of line 11 of Figure 2-2 is the time that the SCSI 
ACK signal was first asserted in the Command phase (line 
26 of Figure 2-3). 


Information transferred during SCSI data in or data out phases may 
be 8 or 16 bits wide. You may specify the width of the data displayed as 
either 8 or 16 bits. Figures 2-2 and 2-3 show 8-bit data displays. Figures 
2-5 and 2-6 show 16-bit displays for both state and timing modes. 


You choose between these two modes after the data has been cap¬ 
tured, and you can move back and forth between 8 and 16-bit dis¬ 
plays with the same captured data as your analysis requires. 


r 


NOTE 


For analysis of 8-bit SCSI buses in timing mode, the 8-bit 
mode is recommended because the data is displayed in both 
binary and hexadecimal representations. In 16-bit mode, 
only a hexadecimal representation is available. 


J 


Capture data can be displayed to the printer, to a disk file, or to 
the computer's screen. 

Displaying to the Printer Or a Disk File 

If the data is to be displayed to the printer or a disk file, you 
specify the format (Timing/State, Real Time/Delta Time, 8-bit/16- 
bit), the first line to display, and the number of lines to display. 

These lines will be printed or written to the disk file as requested. 
This display will be static. To get another format or range of lines, 
you will have to make another display request. In the case of the 
printer, the second request will be printed after the first request. In 
the case of a disk file, the second request will be concatenated to the 
end of the first request. Figures 2-2 through 2-6 are examples of data 
displays to the printer. 
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Displaying To The Computer's Screen 

If the data is to be displayed to the computer's screen, you may 
interactively change the data format and the range of lines dis¬ 
played. Figure 2-7 shows a display to the computer's screen in the 
state, real time, and 8-bit modes. There is a cursor which highlights 
one of the lines in reverse video. Initially, the cursor line is line 0. 

Interactive Display Control 

This display is dynamic. Whether the display was requested from 
the menu or a user test, you can alter it with the following key¬ 
strokes: 


FI 

F2 

F3 

down arrow 

up arrow 

Page Up 

Page Down 

Return 

Backspace 

Home 

End 

T 

G 

ESC 


Toggle between state and timing modes. 

Toggle between 8-bit and 16-bit modes. 

Toggle between real time and delta time modes. 

Move the cursor down one line. If the cursor is at 
the bottom of the screen, scroll the data up one 
line. 

Move the cursor up one line. If the cursor is at the 
top of the screen, scroll the data down one line. 

Scroll the data down 21 lines. 

Scroll the data up 21 lines. 

Scroll the data up one line. 

Scroll the data down one line. 

Move the cursor to line 0. 

Move the cursor to the last line. 

Move the cursor to the trigger line. 

Move the cursor to any line. You will be 
prompted for the line number. 

Exit the display and return to either the menu or 
the user test. 
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In addition, in state or timing mode you may perform delta time 
calculations between any two lines. To do this, move the cursor to 
one of the lines and type x, move the cursor to the other line and 
type o. The delta time will be displayed in the lower left comer of 
the display. If x precedes o, the time will be positive; otherwise, it 
will be negative. Figure 2-7 shows a delta time between lines 4 and 
14 of +0.002_413_200. If x or o is marking a line, then typing x or o 
will return that marker to the cursor line. 

Searching In Timing Mode 

In timing mode only, you can specify search conditions. To search 
forward, type F, and, to search backward, type B. You will then be 
prompted for the desired state of each SCSI and external input 
signal. 

The following keys move between fields: 

Tab Move one field to the right. 

down arrow Move one field to the right. 

Back Tab Move one field to the left. 

up arrow Move one field to the left. 

Home Move to the leftmost field. 

End Move to the rightmost field. 

For each SCSI control line and external input, you may specify the 
following: 

X Any state 

0 Deasserted 

P Transition from deasserted to asserted 

1 Asserted 

N Transition from asserted to deasserted 

You may either type the values directly or you may toggle between 
them with the space bar, +, -, right arrow, or left arrow keys. When 
you type the values directly, the cursor will automatically move to 
the next signal to the right. When you toggle, the cursor does not 
move. 
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For each data nibble, you may either type the value directly (0-F or X 
for any state) or you may toggle between the values the same as for 
control lines. Typing directly will move the cursor to the next signal 
to the right; toggling will not move the cursor. 

Once the desired search condition has been defined, typing Enter 
will start the search. If the search condition is found, the cursor will 
move to that line. You may then repeat the search by typing N. If 
the search condition is not found, an error message will be dis¬ 
played, and the cursor will not move. 

Typing Esc will exit the search mode without starting a search. 

You may define up to five different search conditions. To move 
between the different conditions during search condition specifica¬ 
tion use the Page Up and Page Down keys. 


Capture data can be transported in two forms: formatted or 
unformatted. 

Formatted data is transported by specifying that data is to be dis¬ 
played to a file. This file may either be on a floppy or copied from 
the hard disk to a floppy using the DOS Copy command. In the case 
of formatted data, the data that is displayed is static. What you save 
is what you get. This is useful for reporting problems to people who 
may not own the SDS-310F. 

Unformatted data allows dynamic analysis on remote SDS-310F 
systems. Unformatted data files are created automatically by the 
analyzer software each time capture data is first analyzed. The name 
of the file used is specified with either the interactive menu Data File 
command or the run time function library sba_data_file function. 
The extension of this file will always be .TIM. For state mode, the 
software will also automatically create a file with the same name, but 
an extension of .SIT. This .STT file is not necessary for transporting 
unformatted data. It can be generated from the .TIM file. The same 
is not true of the .TIM file. It cannot be generated from the .STT. 
Therefore, you should be sure to transport the .TIM file. 

If the recipient of this .TIM file has an SDS-310F, they can analyze 
the data with either the interactive menu or a user test the same as if 
they had captured the data on their SDS-310F. 
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Figure 2-2. State Mode 
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Figure 2-5, State Mode 16 Bits 
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Figure 2-6. Timing Mode 16 Bits 
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Figure 2-7. Interactive Display 
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Chapter 13 


Interactive 

Menu 



NOTE 


This chapter assumes you have already installed the 
analyzer hardware and software on your computer. See the 
Installation chapter of this manual for details. 


Invoking 
the Menu 


There are two ways to invoke the menu: 

1. Invoke the menu directly from the DOS command line. 

2. Set up your computer to invoke the menu anytime that ALT-A is 
typed from the keyboard. 

With either method, if you have installed your analyzer hardware 
and software correctly, and you have configured your DOS environ¬ 
ment properly for analyzer operation, the menu's Bus Analyzer 
Functions page will be displayed: 



SDS-310F SCSI Bus Analyzer (Version 2.0) 


Copyright 1991, Adaptec, Inc. 

STATUS: IDLE 


MESSAGE: 




Trigger 

[Immediate | XX X XX XXX X XX | XXXX | 0x0011 Before] 

Trigger Data 

[XXXX XXXX XXXX XXXX] 

Event Filter 

[ 8[Off ] 

Acq Qualifier 

[All State 10x0000000010x000000010] 

ID Qualifier 

[01 x | x 1010] 

Config Mode 

[Direct ] 

Output Device 

[PrinterIDISPLAY.DAT ] 

Data File 

[SBADATA ] 

1 Run 


2 Monitor 


3 Display Data 

[ 00001 49|Screen |Timing 8 |Real Time ] 

C Clear 


- Z,E, A E, — 

wMm exit 


Figure 3-1. Bus Analyzer Functions Menu Page 
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Invoking the Menu Directly From the DOS Command Line 

To invoke the menu directly from the DOS command line, type 
ANALYZER<Enter>. 

You may specify a parameter file name as a parameter to the ANA¬ 
LYZER command. In this case, the menu will automatically config¬ 
ure itself according to the information in this file. If you do not 
specify an extension with this file name, the extension .CFG will be 
automatically assumed. See the Parameter File command descrip¬ 
tion in this chapter for details. 


Invoking the Menu With SBATSR and ALT-A 

To configure your system to invoke the menu anytime ALT-A is 
typed, type SBATSR<Enter> from the DOS command line. Each 
time you boot your computer, you only need to execute this com¬ 
mand once. 

SBATSR will load a small (approximately 11 KByte) terminate and 
stay resident (TSR) program in your computer's memory. After this 
TSR is loaded, each time you type ALT-A, regardless of the applica¬ 
tion that is running when you type it, the TSR will: 

1. Swap out the current application to your hard disk. 

2. Invoke the menu. 

3. When you exit the menu, reload and resume the application that 
was executing when you invoked the menu. 

This method allows you to invoke the menu from any DOS applica¬ 
tion, including SCSI emulation utilities such as the SDS-3F Develop¬ 
ment System's Menu, Interpreter, Shell, or one of your own SCSI C 
Library or Power User Package user tests. 

f NOTE 'N 

For more information on the SDS-SF Development System 
and its SCSI emulation utilities, contact your local Adaptec 
_ sales representative. _ 
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Each time you invoke the menu with ALT-A, it will automatically 
configure itself according to the last Parameter File used. See the 
Parameter File command description in this chapter for details. 


r 


NOTE 


If you always save the current parameters each time you 
exit the menu, the next time you enter the menu it will he 
configured exactly as you left it. See the the Save and 
Exit command description for a convenient way to save 
parameters before exiting. 


J 


Except for the DOSED IT utility, SBATSR is not guaranteed to 
operate correctly when other TSR programs are loaded in memory. 


| Menu Pages 


The menu has two pages: Bus Analyzer Functions and Parameter 
Save and Exit. To move between the two pages, use the right arrow 
and left arrow keys or: 

1. Type Z to go to Bus Analyzer Functions (ANZ). 

2. Type E to go to Parameter Save and Exit (EXIT). 



Figure 3-2. Parameter Save and Exit Page 
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Each menu page has two windows. The top window shows ana¬ 
lyzer status, any error messages, and on-line help. Analyzer status is 
interpreted as follows: 


IDLE The analyzer is not running and the capture buffer 

is empty. 

RUNNING The analyzer is running but the trigger has not 
occurred. 

TRIGGERED The analyzer is running, the trigger has occurred, 
but the capture buffer is not full. 

COMPLETE The analyzer is not running, the trigger has 
occurred, and the capture buffer is full. 

The bottom window shows the analyzer commands and their cur¬ 
rent parameter values. 

If a command is preceded by a highlighted character, that command 
is executed by typing the key corresponding to that character. That 
key is called the hot key for the function. If a command is not pre¬ 
ceded by a highlighted character, it will execute automatically after 
its parameters are edited. 


I Editing 

1 Parameters 

To enter or exit the parameter edit mode, type Ctrl-E. You may 
also exit the parameter edit mode by typing the Esc key. 


Use the following keys to move between parameters (on line help is 
displayed in the top window of the menu page for each parameter 
you select): 


down arrow 

Move to the next parameter to the right. If the 
current parameter is the last parameter of the 
current command, move to the first parameter of 
the next command. 


Tab 

Same as down arrow. 


Enter 

Same as down arrow. 


up arrow 

Move to the next parameter to the left. If the 
current parameter is the first parameter of the 
current command, move to the last parameter of 
the preceding command. 


Back Tab 

Same as up arrow. 

54 I SDS-310F 

Chapter 3: Interactive Menu 





PgUp Move to the first parameter of the preceding command. 

PgDn Move to the first parameter of the next command. 

Home Move to the first parameter of the first command. 

End Move to the first parameter of the last command. 

There are three types of parameters: 

Toggle The values for toggle parameters are predefined. There are 

two methods of choosing from among these predefined 
values: 

1. Type the space bar, +, right arrow, or left arrow key 
to toggle between the predefined values. 

2. Type Ctrl-O to display the list of predefined values in 
the top menu window. Values are listed in alphabetical 
order with an arrow indicating the current selection 
value. Typing the Enter key will set the value of the 
parameter to the current selection value and exit the 
Ctrl-O display. You can move the selection arrow by 
typing the up arrow, down arrow, PgUp, PgDn, Home 
and End keys. You may also start typing the name of 
the value you want until enough characters have been 
entered to point the selection arrow to the desired value. 

You may hit ESC at any time to leave the current param¬ 
eter value unchanged and exit the Ctrl-O display. 

Numeric The value of this parameter is a number. Numbers may be 
entered in decimal (0,10,1054) or hexadecimal (0x0, OxA, 
0x41E). 

String The value of this parameter is a string of characters (typi¬ 

cally a DOS file or path name). Type the characters you 
want. If a string already exists, the characters you type will 
overwrite the current characters starting at the current 
position. Use the right arrow and left arrow keys to 
change the current position. Use the Del key to delete the 
character at the current position and shift all following 
characters one position left. Use the Ins key to enter insert 
mode. In insert mode, each time you type a character all 
characters starting at the current position will be shifted 
right and the character you type will be inserted at the 
current position. 

If you are editing a parameter, but decide you want to return it to its 

original value, type Ctrl-R. 
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Menu Commands command 


Description 


Acq Qualifier 


Config Mode 
Data File 
Display Data 
Event Filter 


ID Qualifier 
Load Parameters 
Monitor 
Output Device 
Parameter File 


Save and Exit 
Save Parameters 
Trigger 
Trigger Data 
Working Directory 


Configure the acquisition qualifier. 

Stop data capture and clear the capture buffer. 
Specify the analyzer configuration. 

Specify a file name for the unformatted capture data. 
Format and display the capture data. 

Configure the event filter. 

Exit the menu. 

Configure the ID qualifier. 

Load the menu parameters. 

Monitor the SCSI bus. 

Specify the device and file for formatted display data. 
Specify a file to hold the menu parameters. 

Start data capture. 

Save the menu parameters and exit the menu. 

Save the menu parameters. 

Configure the non-data part of the trigger. 

Configure the data part of the trigger. 

Specify the directory to hold all data files. 


NOTE 

A typical menu session consists of the following steps: 

1. Configure the data capture hardware as appropriate 
with the Trigger, Trigger Data, Event Filter, Acq 
Qualifier, and ID Qualifier commands. 

2. Start the data capture hardware with the Run com¬ 
mand. 

3 . Wait for the data capture to complete. 

4. View the captured data with the Display Data 
command. 
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Acq Qualifier [mode I start I count] 


Configure the acquisition qualifier. See the Acquisition Qualifier section 
of this manual for details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 

mode A toggle parameter specifying the acquisition mode: 

All State Capture events of all bus phases. 

Arb Sel Capture events of arbitration, 

selection, and reselection phases 
only. 

Arb Sel Cmd Capture events of arbitration, 

selection, reselection, and command 
phases only. 

Arb Sel Cmd Stat Capture events of arbitration, 

selection, reselection, command, 
and status phases only. 

Default: All State 

start A numeric parameter (0-4294967295/ OxO-OxFFFFFFFF) 
specifying the offset of the byte/word in each data in or 
data out phase to capture. 

This parameter is only used in All State mode. 

Default: 0x0000 

count A numeric parameter (0-4294967295/OxO-OxFFFFFFFF) 
specifying the maximum number of consecutive bytes/ 
words in each data in or data out phase to capture. 

This parameter is only used in All State mode. 

Default: 0x00010 


NOTE 

Setting mode to All State and count to 0 disables the saving of 
data phases. In this case, the events of all non-data phases, 
including messages, will be saved. 
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Clear 


Stop data capture and clear the capture buffer. 

Menu Page: Bus Analyzer Functions (ANZ) 
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Config Mode [mode] 

Specify the analyzer configuration. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 

mode A toggle parameter specifying the SCSI bus connection 

mode: 

Direct The SCSI bus is connected to the analyzer 

PCB's 68-bit T' connector either directly or 
through the SCSI T' connector translator 
(One of configurations 1,2,3,4, 7, 8,10, or 
11 as described in the Connecting the 
SCSI Bus Section of this manual). 

Indirect The SCSI bus is connected to another 

PCB's SCSI connector and that PCB is 
connected to the analyzer PCB's internal J3 
connector (One of configurations 5,6,9,12, 
or 13 as described in the Connecting the 
SCSI Bus Section of this manual). 

Default: The menu software automatically sets this 

parameter when the menu is first invoked. If 
in configuration 1,2,3,4,7,8,10, or 11, mode 
will be set automatically to Direct; otherwise, it 
will be set to Indirect 


NOTE 

Change this parameter when you change from the menu start up 
configuration. Be careful. If this parameter is set incorrectly, 

each hit of the capture data will he inverted. _ > 
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Data File [file] 


Specify a file name for the unformatted capture data. See the Transporting 
section of this manual for details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 

file A string parameter (up to 8 characters) specifying a valid 

DOS file name without extension. The menu will use this 
name to create one or more internal files, depending on 
analyzer use. Each file will have the same file name with a 
unique extension. These files will be put in the directory 
specified by the Working Directory command. 

Default: SBADATA 
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Display Data [start I count I device I mode I time ] 

Stop data capture (if not already stopped), and format and display the 
capture data. See the Analyzing the Captured Data section of this manual 
for details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: 3 

start A numeric parameter (0-65535/OxO-OxFFFF) specifying the 
number of the first line to display. 

Default: 0000 

count A numeric parameter (0-65535/OxO-OxFFFF) specifying the 
number of lines to display. 

This parameter is used only if the device parameter is set to 
Out Dev. 

Default: 49 

device A toggle parameter specifying the device to receive the 
display data: 

Screen Display the data interactively on the 

computer monitor. 

Out Dev Write the display data to the device 

specified with the Output Device com¬ 
mand. 

Default: Screen 

mode A toggle parameter specifying the display mode: 

Timing 16 Timing mode with 16 bit data. 

Timing 8 Timing mode with 8 bit data. 

State 16 State mode with 16 bit data. 

State 8 State mode with 8 bit data. 

Default: Timing 8 

time A toggle parameter specifying the time stamp type: 

Real Time The time stamp for each event will 

show the time from capture start until 
that event. 

Delta Time The time stamp for each event will 

show the time from the immediately 
preceding event until that event. 

Default: Real Time 
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Event Filter [width I mode ] 


Configure the event filter. See the Event Filter section of this manual for 
details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 
width A toggle parameter specifying the SCSI data bus width: 

8 The SCSI bus is an 8-bit bus. Process 

transitions of SCSI data lines D0-D7 and 
parity bit DPO, but ignore all transitions on 
SCSI data lines D8-D15 and DPI. 

16 The SCSI bus is a 16-bit bus. Process 

transitions of all SCSI data lines D0-D15 
and parity bits DPO and DPI. 

Default: 8 


r 


NOTE 




Setting this parameter to 16 during analysis of an 8-bit bus will 
work. However, if any of the analyzer inputs corresponding to 
the upper 8 data bits is floating, inadvertent transitions may 
cause unwanted data captures and waste the capture buffer. 




mode A toggle parameter specifying the event filter mode for 

information transfers: 

Off The event filter is disabled. 

Four Per For each information transfer byte/word, 

capture events only on control line transi¬ 
tions. 

One Per For each information transfer byte/word, 

capture events only when data is valid. 

Default: Off 


62 


SDS-310F 


Chapter 3: Interactive Menu 




Exit 


Exit the menu. 

Menu Page: Parameter Save and Exit (EXIT) 


Hot Key: 1 
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ID Qualifier [mode I iid I tid I storage I trigger ] 

Configure the ID qualifier. See the ID Qualifier section of this manual for details. 
Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 

mode A toggle parameter specifying the ID qualifier mode: 

0 Disabled. 

1 Enabled for selections and reselections. 

2 Enabled for selections only. 

3 Enabled for reselections only. 

Default: 0 

iid A toggle parameter specifying the SCSI initiator ID: 

0 Initiator ID 0 only. 

1 Initiator ID 1 only. 

2 Initiator ID 2 only. 

3 Initiator ID 3 only. 

4 Initiator ID 4 only. 

5 Initiator ID 5 only. 

6 Initiator ID 6 only. 

7 Initiator ID 7 only. 

X Any initiator ID. 

Default: X 

tid A toggle parameter specifying the SCSI target ID: 

0 Target ID 0 only. 

1 Target ID 1 only. 

2 Target ID 2 only. 

3 Target ID 3 only. 

4 Target ID 4 only. 

5 Target ID 5 only. 

6 Target ID 6 only. 

7 Target ID 7 only. 

X Any target ID. 

Default: X 

storage A toggle parameter specifying the option for the acquisi¬ 
tion qualifier: 

0 Disabled. 

1 Enabled without arbitration, selection, and 
reselection suppression. 

2 Enabled with arbitration, selection, and 
reselection suppression. 

Default: 0 

trigger A toggle parameter specifying the option for the trigger: 

0 Disabled. 

1 Enabled. 

Default: 0 



SDS-310F 


Chapter 3: Interactive Menu 



Load Parameters 


Load the menu parameters from the file specified with the Parameter File 
command. 

Menu Page: Parameter Save and Exit (EXIT) Hot Key: L 

^ NOTE ^ 

If you subsequently exit the menu and reinvoke it with the ALT-A 
option , the menu will be automatically loaded with this parameter file. 

V__ ) 
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Monitor 


Monitor the SCSI bus. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: 2 

This command is a toggle: if bus monitoring is disabled, executing Monitor 
will enable it; otherwise, executing Monitor will disable it. 

When bus monitoring is enabled, the current state of the SCSI bus will be 
displayed on the bottom line of the computer monitor. SCSI signals that are 
not asserted will be displayed in normal video, and signals that are asserted 
will be highlighted. This monitor feature is especially useful to determine 
the state of a bus that is hung. 

This display will be updated automatically whenever the bus state changes; 
however, because this is a software generated display, there may be delays 
in the display update. 
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Output Device [type I file] 

Specify the device and file for formatted display data. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 
type A toggle parameter specifying the output device: 

Printer The printer. 

File A disk file. 

Default: Printer 

file A string parameter (up to 12 characters) specifying a file 

name with extension. This parameter is only used if the 
type is File. The directory specified with the Working 
Directory command will be used. 

Default: DISPLAY.DAT 
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Parameter File [file] 

Specify a file to hold the menu parameters. 

Menu Page: Parameter Save and Exit (EXIT) Hot Key: none 

file A string parameter (up to 12 characters) specifying a valid 

DOS file name with or without extension. If you do not 
specify a file name extension, .CFG will be appended 
automatically. The directory 

SBADRVA SDS\SDS310F\PRM will be used, where 
SBADRV is the current value of the SBADRV DOS envi¬ 
ronment variable. 

Default: SB APARMS .CFG 
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Run 


Start data capture. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: 1 
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Save and Exit 


Save the menu parameters in the file specified with the Parameter File 
command and exit the menu. 

Menu Page: Parameter Save and Exit (EXIT) Hot Key: V 


NOTE 


If you subsequently invoke the menu with the ALT-A option, the menu 
will be automatically loaded with this parameter file. This provides a 
convenient method for ensuring that you will reenter the menu in the 
same state that you left it. 
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Save Parameters 


Save the menu parameters in the file specified with the Parameter File 
c ommand. 

Menu Page: Parameter Save and Exit (EXIT) Hot Key: P 


NOTE 

If you subsequently exit the menu and reinvoke it with the ALT-A 
option, the menu will be automatically loaded with this parameter file. 

V J 
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Trigger [mode I control I extern I count I position ] 

Configure the nondata part of the trigger. See the Trigger section of this 
manual for details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 
mode A toggle parameter specifying the trigger mode: 

Do not trigger. 

Trigger when the data capture starts. 
Trigger on an arbitration phase. 

Trigger on a selection phase. 

Trigger on a reselection phase. 

Trigger on a message out byte transfer. 
Trigger on a command byte transfer. 
Trigger on a data out byte/word transfer. 
Trigger on a data in byte/word transfer. 
Trigger on a status byte transfer. 

Trigger on a message in byte transfer. 
Trigger on control bus condition. 

Default: Immediate 

control A sequence of 11 toggle parameters (1,0, or X) specifying 
the required state of the SCSI control signals (left to right): 
BSY, SEL, ATN, REQ, ACK, C/D, I/O, MSG, RST, DPI, 
and DPO. 

You may also type the value of each of these parameters 
directly (1,0, or X). In this case, the cursor will move 
automatically to the next parameter to the right. This 
method provides an efficient way to set all 11 control 
parameters with less keystrokes. 

These parameters are only used in the Specify Bits trigger 
mode. 

Default: XX X XX XXX X XX 

extern A sequence of four toggle parameters (1,0, or X) specifying 
the required state (left to right) of external probe pod input 
wires 3,2,1, and 0. 

You may also type the value of this parameter directly 
(1,0, or X). In this case, the cursor will move auto¬ 
matically to the next parameter to the right. This 
method provides an efficient way to set all four extern 
parameters with less keystrokes. 


No Trigger 
Immediate 
Arbitration 
Selection 
Reselection 
Message Out 
Command 
Data Out 
Data In 
Status 
Message In 
Specify Bits 
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These parameters are used in every trigger mode except No 
Trigger and Immediate. 

Default: XXXX 

count A numeric parameter specifying the number of occurrences 
(1-4095/Oxl-OxFFF) of the trigger condition before trigger¬ 
ing. 

This parameter is used in every trigger mode except No 
Trigger and Immediate. 

Default: 0x001 

position A toggle parameter specifying the position of the trigger in 
the capture data: 


Before 

95% of the capture data follows the trigger 
event. 

Center 

The trigger event is centered in the capture 
data. 

After 

95% of the capture data precedes the 
trigger event. 

This parameter is used in every trigger mode except No 
Trigger and Immediate. 

Default: 

Before 


NOTE 

See also the Trigger Data command description. 
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Trigger Data [data] 


Configure the data part of the trigger. See the Trigger section of this 
manual for details. 

Menu Page: Bus Analyzer Functions (ANZ) Hot Key: none 

data A sequence of sixteen toggle parameters (0, 1, or X) specify¬ 

ing the required state (left to right) of the SCSI D15-D0 data 
lines. 

You may also type the value of each of these parameters 
directly (0,1, or X). In this case, the cursor will move 
automatically to the next parameter to the right. This 
method provides an efficient way to set all sixteen data 
parameters with less keystrokes. 

This parameter is used in all trigger modes except No 
Trigger and Immediate. 

Default: XXXX XXXX XXXX XXXX 


r 

L 


NOTE 

See also the Trigger command description. 
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Working Directory [ directory ] 


Specify the directory to hold the files specified by the Data File and Output 
Device commands. 

Menu Page: Parameter Save and Exit (EXIT) Hot Key: none 

directory A string parameter (up to 52 characters) specifying the 
name of an existing DOS directory. 

Default: The directory from which the analyzer menu 

was invoked. 
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Run Time 

Function 

Library 



This chapter assumes you have already installed the 
analyzer hardware and software on your computer , plus the 
SDS-3F SCSI C Library. See the Installation chapter of 
this manual for details. 


SDS-310F 

Functions 


The functions in this section are designed to provide the most 
efficient and effective programming interface to the SDS-310F. If 
you are creating new user tests that will perform analysis, it is 
strongly recommended that you use these functions instead of the 
functions detailed in the Compatible Functions section of this 
chapter, even if you have experience with those other functions. 


scsisba.h The scsisba.h header file prototypes the functions detailed in this 

section. These prototypes are necessary for proper user test compila¬ 
tion. The scsisba.h file also defines all program constant names that 
begin with SB A_. As you create your user tests, you should use the 
names of these constants instead of their values. This will ensure 
compatibility with future software releases. 



You must include this file in your user test source if you are going to 
call any of these functions or use any of these constants. 

Example: 

# include <scsisbaJi> 

l* scsisbaJi prototypes sba_acq_qual and defines SBA_SUCCESS 
and SBA_ALL_STATE. */ 

user_test() 

{ 

unsigned int status; 

if ((status = sba_acq_qual(SB A_ALL_STATE, OL, 4L)) != 
SBA.SUCCESS) 

process_sba_error(status); 

} 
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Function Details 
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Function 

Description 

sba_acq_qual 

Configure the acquisition qualifier. 

sba_ciear 

Stop data capture and clear the capture buffer. 

sba_config_mode 

Specify the analyzer configuration. 

sba data file 

Specify a file name for the unformatted capture data. 

sba delta time 

Calculate the delta time between two lines. 

sba display data 

Format and display the captured data. 

sba event filter 

Configure the event filter. 

sba_id_qual 

Configure the ID qualifier. 

sba interactive_dispiay 

Display data interactively to screen. 

sba log length 

Get the number of lines in the capture buffer. 

sbaresolution 

Set resolution of returned time values. 

sbarun 

Start data capture. 

sba scsi bus 

Get timing line SCSI signal values. 

sba state data 

Get state line data value. 

sba state line 

Find a state line. 

sba_status 

Get the analyzer status. 

sba timingjine 

Find a timing line. 

sbajrigger 

Configure the trigger. 

sba_xlate 

Translate line number from one mode to the other. 


r 


NOTE 


A 


A typical user test analysis consists of the following steps: 

1. Configure the data capture hardware as appropriate with the 
sba_acq_qual, sba_event_filter, sba_id_qual r and sbajrigger 
functions. 

2. Start the data capture hardware with the sbajrun function. 

3. Wait for the data capture to complete. 

4. Analyze the captured data with the sba_delta_time 
sba_display_data, sba_interactive_display r sba_log_length, 
sbajresolution, sba_scsi_bus, sba_state_data, sba_state_line, 
sbajbimingjline, and sbajxlate functions. 
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unsigned int sba_acq_qual(unsigned int mode, unsigned long 
start, unsigned long count); 

Configure the acquisition qualifier. See the Acquisition Qualifier section of 
this manual for details. 

mode The acquisition mode: 


SBA_ALL_STATE Capture events of all bus 

phases. 

SB A_ARB_SEL Capture events of arbitra¬ 

tion, selection, and 
reselection phases only. 

SBA_ARB_SEL_CMD Capture events of arbitra¬ 

tion, selection, reselection, 
and command phases only. 

SBA_ARB_SEL_CMD_STAT Capture events of arbitra¬ 
tion, selection, reselection, 
command, and status 
phases only. 

Default: SBA_ALL_STATE. 

The offset (0L-4294967295/0x0L-0xFFFFFFFFL) of the first 

byte or word in each data phase to capture. 

This parameter is only used in SB A_ALL_STATE mode. 

Default OL. 

The maximum number (0L-4294967295/0x0L-0xFFFFFFFFL) 

of consecutive bytes/words in each data in or data out phase 

to capture. 

This parameter is only used in SBA_ALL_STATE mode. 

Default: 16L. 


count 



SBA ARB SEL 


SBA ARB SEL CMD 


NOTE ^ 


Setting mode to SBA_ALL_STATE and count to OL 
disables the saving of data phases. In this case, the events 
. of all non-data phases, including messages, will be saved. 


Return Values: 


SBA_SUCCESS Successful execution. 

SBA_BAD_START Illegal start value. All parameters returned 

to default values. 

SBA_BAD_COUNT Illegal count value. All parameters returned 

to default values. 

SBA_BAD_MODE Illegal mode value. All parameters returned 

to default values. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

I* Capture all phases, but only the second 10 bytes of each data phase. */ 

unsigned int status; 

status = sba_acq_qual(SBA_ALL_STATE, 10L, 10L); 
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unsigned int sba_clear(void); 

Stop data capture and clear the capture buffer. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

/* Stop data capture and discard the data. */ 
unsigned int status; 
status = sba_clear(); 
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unsigned int sba_config_mode (unsigned int mode ) 

Specify the analyzer configuration. 

Parameters: 

mode The SCSI bus connection mode: 

SBA_DIRECT The SCSI bus is connected to the 

analyzer PCB's 68-bit T' connector 
either directly or through the SCSI T' 
connector translator (One of configu¬ 
rations 1,2,3,4,7,8,10, or 11 as 
described in the Connecting the SCSI 
Bus Section of this manual). 

SB AJNDIRECT The SCSI bus is connected to another 

PCB's SCSI connector and that PCB is 
connected to the analyzer PCB's 
internal J3 connector (One of configu¬ 
rations 5,6,9,12, or 13 as described in 
the Connecting the SCSI Bus Section 
of this manual). 

Default: The RTFL software automatically sets this 

parameter when the user test starts execution. If 
in configuration 1,2,3,4,7,8,10, or 11, mode will 
be set automatically to SBA_DIRECT; otherwise, 
it will be set to SBA_INDIRECT. 


NOTE 

Call this function after you change from the user test start 
up configuration. Be careful. If this parameter is set 
^ incorrectly, each bit of the capture data will he inverted. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBAJBAD_MODE Illegal mode value. Set to default. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

/* Change cable mid-SAT to a differential configuration. */ 
unsigned int status; 

status = sba_config_mode(SBA_INDIRECT); 
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unsigned int sba_data_file(ehar *file)*. 

Specify a file name for the unformatted capture data. See the Analyzing the 
Captured Buffer section of this manual for details. 

Parameters: 

file DOS file name for unformatted captured data. Standard DOS 

file name conventions apply. An extension does not need to 
be specified, as more than one temporary file may be gener¬ 
ated depending on analyzer use. If an extension is specified, 
it will be ignored. A path may be specified as part of the file 
name. If a path is not specified, the current directory will be 
used. 

Default: "SBADATA". 


Return Values: 


Successful execution. 

Illegal file value. Returned to default. 
File could not be opened, file returned to 
default. 

Analyzer not found. 

Example: 


SBA.SUCCESS 

SBA_BAD_FILE 

SBA_FILE_ERR 

SBA_NOT_FOUND 


/* Rename raw data file for later reference. */ 
unsigned int status; 

status = sba_data_file( // D:\USER\AD060792"); 
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unsigned int sba_delta_time(unsigned int mode, unsigned int 
Uriel, unsigned int line2, unsigned long Hime) 

Calculate the delta time between two lines. See the Capture Buffer section of 
this manual for details on delta times. See the Analyzing the Captured Data 
section of this manual for details on timing and state lines. 

Parameters: 

mode The analysis mode: 

SBA_TEVIING Calculate the delta time between two 
timing lines. 

SB A_STATE Calculate the delta time between two 

state lines. 

linel The number of the first line to use in the delta time calcula¬ 

tion. 

line! The number of the second line to use in the delta time calcula¬ 

tion. 

time Returns with the delta time value. Units are as specified by 

the sba_resolution function. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBA_BAD_MODE Illegal mode value. 

SBA_NOJLINE1 Line linel not found. 

SBA_NO_UNE2 Line line! not found. 

SBA_NO_DATA Capture buffer is empty. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

l* Get time between the 1st and 10th events. *1 
unsigned long delta_time; 
unsigned int status; 

status = sba_delta_time(SB A_TIMIN G, 0,9, &delta_time); 
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unsigned int sba_display_data(unsigned int start; unsigned int 
count, unsigned int mode, unsigned int time); 

Stop data capture (if not already stopped), format, and display the captured 
data. See the Analyzing the Captured Data section of this manual for details. 

Parameters: 

start The number (O-65535/OxO-OxFFFF) of the first line to display. 

count The number (O-65535/OxO-OxFFFF) of lines to display. 

mode The display mode: 

SBA_TEVHNG_16 Timing mode with 16-bit data. 

SB A_TIMING_8 Timing mode with 8-bit data. 

SBA_STATE_16 State mode with 16-bit data. 

SB A_STATE_8 State mode with 8-bit data. 

time The time stamp type: 

SBA_REAL_TTME The time stamp for each event will 

show the time from capture start 
until that event. 

SBA_DELTA_TTME The time stamp for each event will 

show the time from the immediately 
preceding event until that event. 

Return Values: 

SBA.SUCCESS 
SBA_BAD_MODE 
SBA_BAD_TTME 
SBA_TOO_FEW_LINES 
SBA_NO_DATA 
SBA_NOT_FOUND 

Example: 

l* Display 16-bit timing data with elapsed time stamps to standard 
output *1 

unsigned int result; 

result = sba_display_data(0, OxFFFF, SBA_TIMING_16, 
SBA_REAL_TIME); 


Successful execution. 

Illegal mode value. 

Illegal time value. 

Less than start lines in capture buffer. 
Capture buffer is empty. 

Analyzer not found. 
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unsigned int sba_event_filter(unsigned int width, unsigned int 
mode)} 

Configure the event filter. See the Event Filter section of this manual for 
details. 

Parameters: 

width The SCSI data bus width: 

8 The SCSI bus is an 8-bit bus. Process transi¬ 

tions of SCSI data lines D0-D7 and parity bit 
DPO, but ignore all transitions on SCSI data 
lines D8-D15 and DPI. 

16 The SCSI bus is a 16-bit bus. Process transi¬ 

tions of all SCSI data lines D0-D15 and parity 
bits DPO and DPI. 

Default: 8. 

^ NOTE ^ 

Setting this parameter to 16 during analysis of an 8-bit bus 
will work. However, if any of the analyzer inputs corre¬ 
sponding to the upper 8 data bits is floating, inadvertent 
transitions may cause unwanted data captures and waste 
^ _ the capture buffer. _ 

mode Specify the event filter mode for information transfers: 

SBA_OFF The event filter is disabled. 

SB A_FOUR_PER For each information transfer byte/ 

word, capture events only on 
control line transitions. 

SB A_ONE_PER For each information transfer byte/ 

word, capture events only when 
data is valid. 

Default: SBA_OFF. 

Return Values: 

SBA.SUCCESS 
SBA_BAD_WIDTH 

SBAJBAD.MODE 

SBA_NOT_FOUND 

Example: 

I* On 8-bit bus, suppress all SCSI data and parity line transitions. *1 
unsigned int status; 

status = sba_event_filter(8 / SBA_FOUR_PER); 


Successful execution. 

Illegal undth value. Both parameters 
returned to default values. 

Illegal mode value. Both parameters re¬ 
turned to default values. 

Analyzer not found. 
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unsigned int sba_id_qual(unsigned int mode, unsigned int iid, 
unsigned int tid, unsigned int storage, unsigned int trigger)', 


Configure the ID qualifier. See the ID Qualifier section of this manual for 
details. 

Parameters: 


mode 


The ID qualifier mode: 


SBA.OFF 

SBA_SEL_RESEL 

SBA_SEL 

SBA.RESEL 


Disabled. 

Enabled for selections and 
reselections. 

Enabled for selections only. 
Enabled for reselections only. 


Default: SBA.OFF. 


iid The SCSI initiator ID: 


tid 


0 

1 

2 

3 

4 

5 

6 
7 

SBA.ANY 


Initiator ID 0 only. 
Initiator ID 1 only. 
Initiator ID 2 only. 
Initiator ID 3 only. 
Initiator ID 4 only. 
Initiator ID 5 only. 
Initiator ID 6 only. 
Initiator ID 7 only. 
Any initiator ID. 


Default: SBA_ANY. 


The SCSI target ID: 


0 

1 

2 

3 

4 

5 

6 
7 

SBA.ANY 


Target ID 0 only. 
Target ID 1 only. 
Target ID 2 only. 
Target ID 3 only. 
Target ID 4 only. 
Target ID 5 only. 
Target ID 6 only. 
Target ID 7 only. 
Any target ID. 


Default: SBA_ANY. 
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storage The option for the acquisition qualifier: 


SBA_OFF Disabled. 

SBA_ALLOW Enabled without arbitration, selection, 

and reselection suppression. 

SBA_SUFPRESS Enabled with arbitration, selection, 
and reselection suppression. 

Default: SBA.OFF. 

trigger The option for the trigger: 

SBA.OFF Disabled. 

SBA_ALLOW Enabled. 

Default: SBA.OFF. 

Return Values: 

SBA.SUCCESS 
SBA_BAD_MODE 

SBA_BAD_IID 

SBA_BAD_TID 

SBA_BAD_STOR 

SBA_BAD_TRIG 

SBA_NOT_FOUND 

Example: 

I* Capture just interactions with target ID 7. */ 
unsigned int status; 

status = sba_id_qual(SBA_SEL_RESEL, SBA_ANY, 7, SB A_ALLOW, 
SBA_OFF); 


Successful execution. 

Illegal mode value. All parameters returned 
to default values. 

Illegal iid value. All parameters returned to 
default values. 

Illegal fid value. All parameters returned to 
default values. 

Illegal storage value. All parameters re¬ 
turned to default values. 

Illegal trigger value. All parameters re¬ 
turned to default values. 

Analyzer not found. 
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unsigned int sba_interactive_display(unsigned int start , 
unsigned int mode, unsigned int time); 

Stop data capture (if not already stopped), and format and display the cap¬ 
tured data. See the Analyzing the Captured Data section of this manual for 
details. 

Parameters: 


start The number (0-65535/0x0-0xFFFF) of the first line to display. 

mode The display mode: 


SB A_TIMIN G_16 
SB A_TEV1IN G_8 
SBA_STATE_16 
SBA_STATE_8 

time The time stamp type: 

SBA_REAL_TIME 


SBA_DELTA_TEVTE 


Timing mode with 16-bit data. 
Timing mode with 8-bit data. 
State mode with 16-bit data. 
State mode with 8-bit data. 


The time stamp for each event will 
show the time from capture start 
until that event. 

The time stamp for each event will 
show the time from the immediately 
preceding event until that event. 


Return Values: 


SBA.SUCCESS 

sba_bad_mode 

SBA_BAD_TTME 

SBAJTOOJFEWIINES 

SBA.NOJDATA 

SBA_NOT_FOUND 


Successful execution. 

Illegal mode value. 

Illegal time value. 

Less than start lines in capture buffer. 
Capture buffer is empty. 

Analyzer not found. 


Example: 

l* Display 16-bit timing data with elapsed time stamps to standard 
output. *1 

unsigned int result; 

result = sba_interactive_display( 0,SB A_TTMIN G_16, SBAJREALJITME); 
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unsigned int sba_log_length(unsigned int mode, unsigned int 
Hines); 

Stop data capture (if not already stopped) and get the number of lines in the 
capture buffer. See the Analyzing the Captured Data section of this manual 
for details on lines. 

Parameter: 

mode The analysis mode: 

SB A_TIMING Get the number of timing lines. 

SBA_STATE Get the number of state lines. 

lines Returns with the number of lines. 

Return Values: 

SBA.SUCCESS 
SBA_BAD_MODE 
SBA_NO_DATA 
SBA_NOT_FOUND 

Example: 

I* Get the number of events in the capture buffer. */ 
unsigned int length; 
unsigned int status; 

status = sba_log_length(SBA_TTMING / &length); 


Successful execution. 
Illegal mode value. 
Capture buffer is empty. 
Analyzer not found. 
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unsigned int sba_resolution(unsigned int res), 


Set resolution of returned time values. 

Parameter: 

res Resolution: 

SBA_SEC Seconds. 

SBA_MSEC Milliseconds. 

SBAJLJSEC Microseconds. 

SBA_NSEC_100 100 nanoseconds. 

SBA_NSEC_20 20 nanoseconds. 

SBA_NSEC Nanoseconds. 

Default: SBA_NSEC_20. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBA_BAD_RES Illegal res value. Returned to default value. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

f* Set time resolution to nanoseconds. */ 

unsigned int status; 

status = sba_resolution(SBA_NSEC); 
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unsigned int sba_run(void); 

Start data capture. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

I* Start data capture. */ 
unsigned int status; 
status = sba_nm(); 
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unsigned int sba_scsi_bus(uiisigned int line, unsigned long 
*control, unsigned long *data ); 

Get timing line SCSI signal values. See the Analyzing the Captured Data 
section of this manual for details on timing lines. 

Parameter: 

line The time line number whose signal values to return. 

contro l Returns as follows: 

Bit pairs 30/31,28/29,26/27,24/25,22/23,20/21,18/19,16/ 
17, and 14/15 corresponding to the SCSI BSY, SEL, ATN, 
REQ, ACK, C/D, 1/O, MSG, and RST signals, respectively. 

Bit pairs are interpreted as follows: 

msb Isb Interpretation 

1 0 Asserted 

1 1 Transition from asserted 

to deasserted 

0 0 Deasserted. 

0 1 Transition from deasserted 

to asserted 

Bit 13 corresponds to the trigger and is 1 if the specified line is 
the trigger event; 0 otherwise. 

Bits 9 and 8 correspond to the SCSI DPO and DPI signals, and 
Bits 3 to 0 correspond to the EXT3, EXT2, EXT1, and EXTO 
signals, respectively. 1 is interpreted as asserted, and 0 as 
deasserted. 

data Returns as follows: 

Bits 15 to 0 correspond to the SCSI D15 to DO lines, respec¬ 
tively. 1 is interpreted as asserted, and 0 as deasserted. 

Return Values: 

SBA_SUCCESS Successful execution. 

SBA_TOO_FEW_LINES Less than line lines in capture buffer. 

SBA_NO_DATA Capture buffer is empty. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

I* Get the SCSI signal values for timing line 100. */ 
unsigned long control; 
unsigned long data; 
unsigned int status; 

status = sba_scsi_biis( 100 , &control, &data); 
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unsigned int sba_state_data(unsigned int start, unsigned int 

state, unsigned int count, unsigned int offset, unsigned long *data :); 

Get state line data value. See the Analyzing the Captured Data section of this 
manual for details on state lines. 


Parameters: 


start The starting location (reference point) and direction of the 

search for the state line to get the information transfer byte 
from: 


state 


SBA_START_OF_LOG 

SBA_END_OF_LOG 

SBA_AFTER_TRIGGER 

SBA_BEFORE_TRIGGER 


Search forward from the first 
captured event. 

Search backward from the last 
captured event. 

Search forward from the 
trigger event 
Search backward from the 
trigger event 


The type of the state line to get the information transfer byte/ 
word from: 


SBA_ARBITRATE 

SBA_ARBWIN 

SBA_SEL_START 

SBA_RESEL_START 

SB A_MS G_OUT 

SBA.CMD 

SBA.DATAOUT 

SBA_DATAIN 

SBA_STAT 

SBA_MSG_IN 


At least one device is arbitrating. 
A device has won arbitration. 

A device is selecting another 
device. 

A device is reselecting another 
device. 

Message out information 
transfer(s). 

Command information 
transfer(s). 

Data out information transfers). 
Data in information transfer(s). 
Status information transfer(s). 
Message in information 
transfer(s). 


count The occurrence count (1-65535/Oxl-OxFFFF) of the state line of 
type state, starting from the event and in the direction 
specified by start, to get the information transfer byte/ word 
from. 


offset The offset (0-4095/OxO-OxFFF) of the data byte/word within 
the selected line to return. 


This parameter is only used when state is an information 
transfer phase. If offset is greater than 5, subsequent state 
lines of the same information transfer phase will be searched. 
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data 


Returns as follows: 


Bits 15 to 0 correspond to the SCSI D15 to DO lines, respec¬ 
tively. 1 is interpreted as asserted, and 0 as deasserted. 


Return Values: 

SBA_SUCCESS 

SBA_NO_STATE 

SBA_BAD_STATE 

sba_bad_start 

SBA_NO_TRIG 

SBA_OBJ_NOT_FOUND 

SBA_NO_DATA 

SBA_NOT_FOUND 

Example: 


Successful execution. 

Phase specified by state not found. 
Illegal state specifier. 

Illegal start specifier. 

No trigger event. 

Data byte/word not found. 
Capture buffer is empty. 

Analyzer not found. 


I* Get data of first data byte of first data in phase. */ 
unsigned long data; 
unsigned int status; 

status = sba_state_data(SBA_START_OF_LOG / SBA_DATAIN / 1, 1, 
&data); 
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unsigned int sba_state_line(unsigned int start r unsigned int dire, 
unsigned int state, unsigned int count, unsigned int *line); 

Find a state line. See the Analyzing the Captured Data section of this manual 
for details on state lines. 


Parameters: 


start Number (0-65535/QxO-OxFFFF) of the first state line to search. 

dire Search direction: 

SBA_FORWARD Search forward. 

SBAJB ACKWARD Search backward. 

state The type of the line to search for: 


SB A_BU S_FREE 
SBA_ARBITRATE 
SBA_ARBWIN 
SBA_SEL_START 

SBA_SEL_COMPLHTE 

SBA_SEL_TTMEOUT 

SBA_RESEL_START 

SBA_RESEL_COMPLETE 

SBA_RESEL_TEMEOUT 
SB A_MS G_OUT 

SBA_CMD 

SBA_DATAOUT 

SBA_DATAIN 

SBA_STAT 

SBA_MSG_IN 

SBA_ATTN_ASSERT 

SB A_ATTN_DEAS SERT 

SBA_RESET_ASSERT 

SBA_RESET_DEASSERT 

SBA_TRIGGER 

count 


The SCSI bus is idle. 

At least one device is arbitrating. 

A device has won arbitration. 

A device is selecting another 
device. 

A device has selected another 
device. 

Selection time out. 

A device is reselecting another 
device. 

A device has reselected another 
device. 

Reselection time out. 

Message out information 
transfer(s). 

Command information transfer(s). 
Data out information transfer(s). 
Data in information transfer(s). 
Status information transfer(s). 
Message in information transfer(s). 
ATN changed from deassert to 
assert 

ATN changed from assert to 
deassert. 

RST changed from deassert to 
assert 

RST changed from assert to 
deassert. 

The trigger event. 


The number of occurrences (1-65536/Oxl-OxFFFF) of state 
lines of type state, starting from the line determined by start 
and in direction dire, to find before returning the line number. 


line Returns with the requested line number. 
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NOTE 


r 






If you set state to SBA_TRIGGER, you should also set 
count to 1. There is at most one trigger event. 


j 


Return Values: 


SBA_SUCCESS 

SBA_BAD_STATE 

SBA_BAD_DIRC 

SBA_NO_DATA 

SBA_OBJ_NOT_FOUND 

SBA_NOT_FOUND 


Successful execution. 

Illegal state value. 

Illegal dire value. 

Capture buffer is empty. 

Line specified by parameters not 
found. 

Analyzer not found. 


Example: 

I* Get the trigger line number. */ 
unsigned int line; 
unsigned int status; 

status = sba_state_line(0, SBAJFORWARD, SBA_TRIGGER, 1, &line); 
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unsigned int sba_status(unsigned int *statusV, 

Get the analyzer status. 

Parameters: 

status Returns with the analyzer status: 

SBAJDLE Not running. 

SBAJRUN Running but the trigger has not oc¬ 

curred. 

SB A_TRIG Running and the trigger has occurred, 

but the buffer is not full. 

SBA_FULL Not running, the trigger has occurred, 

and the buffer is full. 

Return Values: 

SBA_SUCCESS Analyzer found. 

SBA_NOT_FOUND Analyzer not found. 

Example: 

/* Get analyzer status. *1 
unsigned int status; 
unsigned int sba; 
status = sba_status(&sba); 
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unsigned int sba_timing_line (unsigne d int start, unsigned int 
dire, char *control, char *data, unsigned int trigger, unsigned 
int count, unsigned int *line); 

Find a timing line. See the Analyzing the Captured Data section of this 
manual for details on timing lines. 

Parameters: 

start Number (0-65535/OxO-OxFFFF) of the first timing line to 

search. 

dire Search direction: 

SBAJFORWARD Search forward. 

SBAJ3ACKWARD Search backward. 

control A16 character string with characters 0,1,3,5,6,8,9,10, and 
12 corresponding to the SCSI BSY, SEL, ATN, REQ, ACK, C/ 
D, I/O, MSG, and RST control signals, respectively. Each 
character specifies the required state of the corresponding 
signal: '1' (asserted), T' (deasserted to asserted transition), 'O' 
(deasserted), 'N' (asserted to deasserted transition) or 'X' (any 
state). 

Characters 14 and 15 correspond to the SCSI DPI and DPO 
s signals, respectively. Each character specifies the required 

state of the corresponding signal: '1' (asserted), "O' (deas¬ 
serted), or 'X' (any state). 

data A19 character string with characters 0,1,2,3,5,6,7,8,10,11, 

12,13,15,16,17, and 18 corresponding the to SCSI D15-D0 
signals, respectively. Each character specifies the required 
state of the corresponding signal: 'V (asserted), 'O' (deas¬ 
serted), or 'X' (any state). 

trigger Trigger search enable: 

SBA_YES Search for the trigger. 

SB A_NO Do not search for the trigger. 


count The number of occurrences (O-65535/QxO-OxFFFF) of timing 
lines of the type matching control, data, and trigger to find 
before returning the line number. 



line Returns with the number of the requested line. 
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Return Values: 


SBA_SUCCESS 
SB A BAP DATA 

sba_bad_trig 

SBAJBAD_CNTL 
SBA_BAD_DIRC 
SBA_NO_DATA 
SBA_OBJ_NOT_FOUND 

SBA_NOT_FOUND 

Example: 

/* Find the 512th data out transfer. */ 
unsigned int line; 
unsigned int status; 

status = sba_timing_line(0, SBA_FORWARD, "XXXXP0OOX XX", 
"XXXX XXXX XXXX XXXX", SBA_NO, 512, &line); 


Successful execution. 

Illegal {Huts value. 

Illegal trig value. 

Illegal control value. 

Illegal dire specifier. 

Capture buffer is empty. 

Line specified by parameters not 
found. 

Analyzer not found. 
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unsigned int sba_trigger(unsigned int mode, char * control, char 
*data, char * external, unsigned int count, unsigned int 
position); 

Configure the trigger. See the Trigger section of this manual for details. 
Parameters: 


mode The trigger mode: 

SBA_NO_TRIGGER 

SBA_EMMEDIATE 

SBA_ARBITRATION 

SBA.SELECTION 

SBA_RESELECTION 

SBA_MESSAGE_OUT 

SBA.COMMAND 

SBA_DATA_OUT 

SBA_DATA_IN 

SBA_STATUS 

SBA_MESSAGE_IN 

SBA_SPECIFY_BITS 


Do not trigger. 

Trigger when the data capture starts. 
Trigger on an arbitration phase. 
Trigger on a selection phase. 

Trigger on a reselection phase. 

Trigger on a message out byte transfer. 
Trigger on a command byte transfer. 
Trigger on a data out byte/word 
transfer. 

Trigger on a data in byte/word 
transfer. 

Trigger on a status byte transfer. 
Trigger on a message in byte transfer. 
Trigger on control bus condition. 


Default: SBAJMMEDIATE. 

control A16 character string with characters 0,1,3,5,6,8,9,10,12,14, 
and 15 corresponding to the SCSI BSY, SEL, ATN, REQ, ACK, 
C/D, 1/O, MSG, RST, DPI and DPO control signals, respec¬ 
tively. Each character specifies the required state of the 
corresponding signal: '1' (asserted), 'O' (deasserted), or 'X' 
(any state). 

This parameter is only used in the SBA_SPECIFY_BITS 
trigger mode. 

Default: "XX X XX XXX X XX" 

data A19 character string with characters 0,1,2,3,5,6,7,8,10,11, 

12,13,15,16,17, and 18 corresponding the to SCSI D15-D0 
signals, respectively. Each character specifies the required 
state of the corresponding signal: T (asserted), 'O' (deas- 
serted), or 'X' (any state). 

This parameter is used in all trigger modes except 
SBA_NO_TRIGGER and SBAJMMEDIATE. 

Default: "XXXX XXXX XXXX XXXX". 
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external A four character string with characters 0,1, 2, and 3 corre¬ 
sponding to the EXT3, EXT2, EXT1, and EXTO external probe 
pod input signals, respectively. Each character specifies the 

-— /-f / /~— /nr 
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(deasserted), or X' (any state). 


This parameter is used in every trigger mode except 
SBA_NO_TRIGGER and SBA_IMMEDIATE. 

Default: "XXXX". 

count The number of occurrences (1-4095/Oxl-OxFFF) of the trigger 

condition before triggering. 

This parameter is used in every trigger mode except 
SBA_NO_TRIGGER and SBA_IMMEDIATE. 

Default: 1. 

position The position of the trigger in the capture data: 

SBA_BEFORE 95% of the capture data follows the 

trigger event 

SB A_CENTERED The trigger event is centered in the 

capture data. 

SB A_AFTER 95% of the capture data precedes the 

trigger event 

This parameter is used in every trigger mode except 
SBA_NO_TRIGGER and SBAJMMEDIATE. 

Default: SBA_BEFORE. 

Return Values: 


SBA_SUCCESS 

SBA_BAD_MODE 

SBAJBAD_CNTL 

SBA_BAD_DATA 

SBA_BAD_INPUTS 

SBA_BAD_COUNT 

SBA_BAD_POS 

SBA_NOT_FOUND 


Successful execution. 

Illegal mode value. All parameters returned 
to default values. 

Illegal control value. All parameters re¬ 
turned to default values. 

Illegal data value. All parameters returned 
to default values. 

Illegal inputs value. All parameters returned 
to default values. 

Illegal count value. All parameters returned 
to default values. 

Illegal position value. All parameters 
returned to default values. 

Analyzer not found. 


Example: 


f* Trigger on an arbitration by ID 0. */ 
unsigned int status; 

status = sba_trigger(SBA_SPECIFY_BITS, "10 0 00 000 0 XX", "XXXX 
XXXX XXXX XXXI" 'XXXX", 1, SB A.AFTER); 

/^Trigger immediate. *1 
Status=(SBA_IMMEDIATE," " " "AO); 
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unsigned int sba_xlate(unsigned int mode, unsigned int line, 
unsigned int *new) 

Translate line number from one mode to the other. See the Analyzing the 
Captured Data section of this manual for details on timing and state lines. 

Parameters: 


mode The translate mode: 

SBA_TIM3NG Translate from state line number to 

timing line number. 

SB A_STATE Translate from timing line number to 

state line number. 

line The number of the line to translate. 

new Returns with the new line number. 


Return Values: 


SBA_SUCCESS 

sba_bad_mode 

SBA_OBJ_NOT_FOUND 

SBA_NOT_FOUND 


Successful execution. 
Illegal mode value. 
line not found. 
Analyzer not found. 


Example: 

/* Find the timing line that corresponds to state line 1000. */ 
unsigned int line; 
unsigned int status; 

status = sba_xlate(SBA_TIMING, 1000, &line); 
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I Compatible 
Functions 


The following functions are included only to support compatibility 
with the function libraries of the SDS-210, SDS-310, and SDS-310A. These 
functions do not support any of the new features of the SDS-310F. It is strongly 
recommended that you use only the sba-dass functions for any new user test 
development. Furthermore, do not mix these functions with sba-dass func¬ 
tions in the same user test; otherwise, unpredictable results will occur. These 
functions are prototyped in the scsila.h indude file. 


Function 

Description 

la acq qual 

Configure the acquisition qualifier for state mode. 

la delta time 

Calculate delta time between two state mode lines. 

la_display 

Display the capture data. 

la_extern_input 

Configure the external input trigger. 

la file name 

Specify file for the unformatted capture data. 

la find line 

Find state mode line number. 

la get status 

Get analyzer status. 

lajogjength 

Get number of lines in the capture buffer. 

la_run 

Start data capture. 

la state data 

Get state mode data value. 

la_trigger 

Configure the SCSI bus trigger for state mode. 

lat_acq_qual 

Configure the acquisition qualifier for timing mode. 

lat delta time 

Calculate delta time between two timing mode lines. 

lat find line 

Find timing mode line. 

lat line data 

Get timing mode line data value. 

lat_time_stamp 

Get timing mode line time stamp. 

lat_trigger 

Configure the SCSI bus trigger condition for timing mode. 
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unsigned int la_acq_qual(char *mode, unsigned int count); 

Configure the acquisition qualifier for subsequent data captures with the 
la_run("STATE") function. See the Acquisition Qualifier section of this 
manual for details. 

Parameters: 

mode The acquisition mode (state): 

"ALL_STATE" 

"ARB_SEL" 

"ARB_SEL_CMD" 

"ARB_SEL_CMD_STAT" 

Default: "ALL_STATE". 

count The maximum number (1-61439/Oxl-OxEFFF) of consecutive 
bytes in each data in or data out phase, starting with byte 0, to 
save. 

Default: 16. 

This parameter is only used in "ALL_STATE" mode. 


Capture events of all bus 
phases. 

Capture events of arbitration, 
selection, and reselection 
phases only. 

Capture events of arbitration, 
selection, reselection, and 
command phases only. 
Capture events of arbitration, 
selection, reselection, com¬ 
mand, and status phases only. 


Return Values: 

0 Successful execution. 

OxFFFE Illegal count value. Both parameters returned to default 
values. 

OxFFFF Illegal mode value. Both parameters returned to default 
values. 
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unsigned long la_delta_time(char *start f char *statel, unsigned 
int countl, char *state2, unsigned int count 2); 

Calculate the delta time between two state lines in the capture buffer. This 
function requires you to have captured data with the lajrun("STATE") 
function. See the Capture Buffer section of this manual for details on delta 
times. See the Analyzing the Captured Data section of this manual for details 
on state lines. 

Parameters: 

start The starting location (reference point) and direction of the search 

for the first state line to use in the delta time calculation: 

"START_OF_LOG" Search forward from the first captured 

event 

"END_OF_LOG" Search backward from the last cap¬ 

tured event. 

"AFTER_TRIGGER" Search forward from the trigger event. 

"BEFOREJTRIGGER" Search backward from the trigger 

event 

state1 The type of the first line to use in the delta time calculation: 

"BUSJFREE" 

"ARBITRATE" 

"ARBWIN" 

"SEL.START" 

"SEL_COMPLETE" 

"SELJITMEOUT" 

"RESEL_START" 

"RESEL_COMPLETE" 

"RESELjnMEOUT" 

"MSG.OUT" 

"CMD" 

"DATAOUT" 

"DATAIN" 

"STATUS" 

"MSG_IN" 

"ATTN.ASSERT" 

"ATTN_DEASSERT" 

"RESET_AS SERT" 

"RESET.DEASSERT" 

// LINE" 


The SCSI bus is idle. 

At least one device is arbitrating. 

A device has won arbitration. 

A device is selecting another device. 
A device has selected another 
device. 

Selection time out 

A device is reselecting another 

device. 

A device has reselected another 
device. 

Reselection time out 
Message out information transfer(s). 
Command information transfer(s). 
Data out information transfer(s). 
Data in information transfer(s). 
Status information transfer(s). 
Message in information transfer(s). 
AIN changed from deassert to 
assert 

ATN changed from assert to 
deassert. 

RST changed from deassert to 
assert 

RST changed from assert to 
deassert. 

Special mode. See description 
below. 
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countl The occurrence count (1-65535/0x1-OxFFFF) of the state line of 

type statel, starting from the event and in the direction 
specified by start, to use as the first line in the delta time 
calculation. 

statel The type of the second state line to use in the delta time 

calculation. Legal values for statel are the same as those for 
statel. 

countl The occurrence count (1-65535/Oxl-OxFFFF) of state lines of 

type statel, starting from the the line determined by statel 
and countl, and in the forward direction, to use as the second 
line in the delta time calculation. 

If you specify 'TINE" for statel, countl state lines will be counted from the 
event in the direction specified by start to determine the first line to use in the 
delta time calculation, countl state lines will be counted in the forward 
direction from the first line in the delta time calculation to use as the second 
line in the delta time calculation, statel will be ignored. 

Return Values: 

non-OL Successful execution. The exact value is the delta time 

between the two specified lines. Units are microseconds. 

OL Error. Call the get_f_status("IO") function and interpret its 

return value as follows: 

0x40 Line specified by statel/countl not found. 

0x41 Line specified by statel/countl not found. 

0x42 Illegal state specifier. 

0x43 Illegal start specifier. 

0x44 No trigger event. 

0x50 Data not captured with la_run("STATE"). 

OxFE Capture buffer is empty. 
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unsigned int la_display(unsigned int start, unsigned int length); 

Stop data capture (if not already stopped) and display the captured data to the 
device specified with the output_device function. If you captured the data 
with the la_run('TIMING") function, the output will be in the 8-bit real time 
timing mode format. If you captured the data with the la_mn("STATE") 
function, the output will be in the 8-bit real time state mode format. See the 
Analyzing the Captured Data section of this manual for details on the timing 
and state mode formats. 

Parameters: 

start If data was captured with the la_run( // TIMING") function, 

the number (0-65535/OxO-OxFFFF) of the first timing line to 
display. If data was captured with la_run("STATE"), the 
number (0-65535/0x0-0xFFFF) of the first state line to display. 

length If data was captured with the la_run( / TIMING") function, 

the number (0-65535/OxO-OxFFFF) of timing lines to display. 

If data was captured with la_run("STATE"), the number (0- 
65535/OxO-OxFFFF) of state lines to display. If start+length 
exceeds the end the buffer, data is displayed to the end of the 
buffer. 


Return Values: 

0 Successful execution. 

OxFFFE Less than start lines in capture buffer. 

OxFFFF Capture buffer is empty. 


Chapter 4: Run Time Function Library 


SDS-31 OF 


107 



unsigned int la_extem_input(char Hnputs); 

Configure the external input trigger condition for subsequent data captures 
with the la_run function. See the Trigger section of this manual for details. 

Parameters: 

inputs A seven character string with characters 0, 2,4, and 6 corre¬ 

sponding to the EXT3, EXT2, EXT1, and EXTO external probe 
pod input signals, respectively. Each character specifies the 
required state of the corresponding signal: 'T (asserted), 'O' 
(deasserted), or 'X' (any state). 

Default "XXXr. 


Return Values: 

0 Successful execution. 

0xFFF9 Illegal inputs value. Set to default. 
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unsigned int la_file_name(char *name ); 


Specify the name of the file to hold unformatted captured data. See the 
Analyzing the Captured Buffer section of this manual for details on this file 
and its use. 


Parameters: 


name Name of DOS file to hold unformatted captured data. Stan¬ 

dard DOS file name conventions apply. A path may be 
specified as part of the file name. If a path is not specified, the 
current directory will be used. Extensions will be assigned 
automatically. If an extension is specified, that extension will 
be ignored. 

Default SBADATA. 


Return Values: 

0 Successfull execution. 

0xFFF7 Illegal file name. 
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unsigned int la_find_line(unsigned int start, char *dirc, char 
*state, unsigned int count); 

Find a state line number. This function requires you to have captured data 
with the la_run("STATE") function. See the Analyzing the Captured Data 
section of this manual for details on state lines. 

Parameters: 

start Number (0-65535/OxO-OxFFFF) of the first state line to search. 

dire Search direction: 

"FORWARD" Search forward. 

"BACKWARDS" Search backward. 

state The type of the line to search for 

The SCSI bus is idle. 

At least one device is arbitrating. 
A device has won arbitration. 

A device is selecting another 
device. 

A device has selected another 
device. 

Selection time out. 

A device is reselecting another 
device. 

A device has reselected another 
device. 

Reselection time out. 

Message out information 
transfer(s). 

Command information 
transfers). 

Data out information transfers). 
Data in information transfer(s). 
Status information transfers). 
Message in information 
transfers). 

ATN changed from deassert to 
assert 

ATN changed from assert to 
deassert. 

RST changed from deassert to 
assert. 

RST changed from assert to 
deassert. 

The trigger event. 
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"BUS.FREE" 

"ARBITRATE" 

"ARBWIN" 

"SEL.START" 

"SEL.COMPLETE" 

"SELJTTMEOUT" 

"RESEL_START" 

"RESEL.COMPLETE" 

"RESELjnMEOUT" 

"MSG.OUT" 

"CMD" 

"DATAOUT" 

"DATAIN" 

"STATUS" 

"MSGJN" 

"ATTN_ASSERT" 

"ATTNJDEASSERT" 

"RESET_AS SERT" 

"RESET_DEASSERT" 

"TRIGGER" 
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count 


The number of occurrences (1-65536/Oxl-OxFFFF) of state 
lines of type state, starting from the line determined by start 
and in direction dire, to find before returning the line number. 


r 


NOTE 


"\ 


If you set mode to "TRIGGER", you should also set 
count to 1. There is at most one trigger event. 


Return Values: 

<0x8000 Successful execution. The exact value is the number of the 
specified state line. 

0x8042 Illegal state value. 

0x8043 Illegal start value. 

0x8044 Illegal dire value. 

0x8050 Data not captured with la_run("STATE"). 

OxFFFE Capture buffer is empty. 

OxFFFF Line specified by parameters not found. 
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unsigned int la_get_status(void); 

Get analyzer status. 

Return Values: 

0 Running but the trigger has not occurred. 

0x0001 Running and the trigger has occurred, but the buffer is not 

full. 

0x0002 Not running, the trigger has occurred, and the buffer is full. 

0x0003 Not running. 

OxFFFF Analyzer not found. 
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unsigned int la_log_length(void); 


Stop the data capture (if not already stopped). If data was captured with the 
ia_nm{'Tnvm\ G") function, get the number of timing lines in the capture 
buffer. If data was captured with the la_nm("STATE") function, get the 
number of state lines in the capture buffer. See the Analyzing the Captured 
Data section of this manual for details on timing and state lines. 

Return Value: 

If data was captured with the la_run("TIMING ,/ ) function, the number timing 
lines in the capture buffer. If data was captured with la_run("STATE"), the 
number of state lines in the capture buffer. 
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unsigned int la_run(char *mode ); 

Start data capture and prepare for analysis in timing or state mode. 


r 


NOTE 




Previous generation bus analyzers had a special hardware mode 
custom tailored for state mode data capture. The SDS-310F does not 
support this special mode of data capture. Instead, it always captures 
data as events that translate directly into timing mode output. All 
state mode data is generated from translations of this timing mode 
capture data. Because the special state capture mode hardware made 
more efficient use of the capture buffer than the timing mode hard¬ 
ware, the state mode capture depth of the SDS-310F may be less than 
previous generation analyzers even though the analyzer's buffer is the 
same physical size. See the Capturing Data section of this manual 
for descriptions of the advanced features of the SDS-310F's data 
capture hardware that may be used to make more efficient use of the 

capture buffer. 


Parameter: 

mode Data analysis mode: 

"STATE" State mode. 

"TIMING" Timing mode. 


Return Values: 

OxOOOO Successful execution. 

OxFFFE Illegal mode value. 

OxFFFF Analyzer not found. 
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unsigned int la_state_data(char *start, char *state, unsigned int 
count, unsigned int offset ); 

Get state line data byte value. This function requires you to have captured 
data with the la_run("STATE") function. See the Analyzing the Captured 
Data section of this manual for details on state lines. 

Parameters: 

start The starting location (reference point) and direction of the 
search for the state line to get the information transfer byte 
from: 


"START_OF_LOG" 

Search forward from the first 
captured event. 

"END_OF_LOG" 

Search backward from the last 
captured event. 

"AFTERTRIGGER" 

Search forward from the trigger 
event 

"BEFORE_TRIGGER" 

Search backward from the trigger 
event 

The type of the state line to 
from: 

get the information transfer byte 

"ARBITRATE" 

At least one device is arbitrating. 

"ARBWIN" 

A device has won arbitration. 

"SEL_START" 

A device is selecting another 
device. 

"RESEL_START" 

A device is reselecting another 
device. 

"MSG.OUT" 

Message out information 
transfer(s). 

"CMD" 

Command information transfer(s). 

"DATAOUT" 

Data out information transfer(s). 

"DATAIN" 

Data in information transfer(s). 

"STATUS" 

Status information transfer(s). 

"MSGJN" 

Message in information 
transfer(s). 


count The occurrence count (1-65535/Oxl-OxFFFF) of the state line of 

type state, starting from the event and in the direction 
specified by start, to get the information transfer byte from. 

offset The offset (0-4095/OxO-OxFFF) of the data byte within the 

selected line to return. 

This parameter is only used when state is an information 
transfer phase. If offset is greater than 5, subsequent state 
lines of the same information transfer phase will be searched. 
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Return Value: 


OxOOXX Where XX is the requested byte. 

For status call the get_f_status("IO") function and interpret its return 
value as follows: 


0 

Successful execution. 

0x40 

Phase specified by state not found. 

0x42 

Illegal state specifier. 

0x43 

Illegal start specifier. 

0x44 

No trigger event. 

0x45 

Data byte not found. 

0x50 

Data not captured with la_run("STATE"). 

OxFE 

Capture buffer is empty. 
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unsigned int la_trigger(char *state, char *data, unsigned int 
count, char location); 

Configure the SCSI bus trigger condition for subsequent data captures with the 
la_nm("STATE") function. See the Trigger section of this manual for details. 

Parameters: 


state Trigger state definition: 


"NO_TRIGGER" 

'IMMEDIATE" 

"ARBITRATION" 

"SELECTION" 

"RESELECTION" 

"MSG_OUT" 

"CMD" 

"DATA_OUT" 

"DATA_IN" 

"STATUS" 

"MSGJCN" 


Do not trigger. 

Trigger as soon as data capture starts. 
Trigger on an arbitration phase. 
Trigger on a selection phase. 

Trigger on a reselection phase. 

Trigger on a message out byte transfer. 
Trigger on a command byte transfer. 
Trigger on a data out byte transfer. 
Trigger on a data in byte transfer. 
Trigger on a status byte transfer. 
Trigger on a message in byte transfer. 


Default: "IMMEDIATE". 


data An eleven character string with characters 0,2,3,4,5,7,8,9, and 

10 corresponding to the SCSI DPO, D7, D6, D5, D4, D3, D2, Dl, 
and DO signals, respectively. Each character specifies the 
required state of the corresponding signal: 'T (asserted), 'O' 
(deasserted), or 'X' (any state). 

Default: "XXXXXXXXX". 


count The number of occurrences (0-65535/OxO-OxFFFF) of the trigger 
condition before triggering. 

Default: 1. 

location The position of the trigger in the capture data: 


"BEFORE" 95% of the capture data follows the trigger. 

"CENTERED" The trigger is centered in the capture data. 
"AFTER" 95% of the capture data precedes the trigger. 


Default: "BEFORE". 


Return Values: 

0 Successful execution. 

OxFFFC Illegal location value. All parameters returned to default 
values. 

OxFFFD Illegal count value. All parameters returned to default values. 
OxFFFE Illegal data value. All parameters returned to default values. 

OxFFFF Illegal state value. All parameters returned to default values. 
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unsigned int lat_acq_qual(char *mode, unsigned int count)', 

Configure the acquisition qualifier for subsequent data captures with the 
la_run( / TIMING") function. See the Acquisition Qualifier section of this 
manual for details. 

Parameters: 

mode The acquisition mode (state): 

"ALL_STATE" Capture events of all bus 

phases. 

"ARB_SEL" Capture events of arbitration, 

selection, and reselection 
phases only. 

/ 'ARB_SEL_CMD' / Capture events of arbitration, 

selection, reselection, and 
command phases only. 

"ARB_S EL_CM D_S TAT" Capture events of arbitration, 

selection, reselection, com¬ 
mand, and status phases only. 

Default: "ALL_STATE". 

count The maximum number (1-61439/Oxl-OxEFFF) of consecutive 

bytes in each data in or data out phase, starting with byte 0, to 

save. 

Default 0x8000. 

This parameter is only used in "ALL_STATE" mode. 


Return Values: 

0 Successful execution. 

OxFFFE Illegal count value. Both parameters returned to default 
values. 

OxFFFF Illegal mode value. Both parameters returned to default 
values. 
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unsigned long lat_delta_time(xmsigned int linel, unsigned int 
line 2); 

Calculate the delta time between two timing lines in the capture buffer. This 
function requires you to have captured data with the la_run( // TIMING") 
function. See the Capture Buffer section of this manual for details on delta 
times. See the Analyzing the Captured Data section of this manual for details 
on timing lines. 

Parameters: 

linel The first timing line number to use in the delta time calcula¬ 

tion. 

line! The second timing line number to use in the delta time 

calculation. 

Return Values: 

non-OL Successful execution. The exact value is the delta time 

between the two specified lines. Units are 100 nanoseconds. 

0L Error. Call the get_f_status('TO") function and interpret its 

return value as follows: 


0x41 

Line linel not found. 

0x42 

Line line2 not found. 

0x50 

Capture data not acquired with 


la_run("TIMIN G"). 

OxFE 

Capture buffer is empty. 
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unsigned int lat_find_Iine(unsigned int start, char *dirc, char 
*control, char *data, char * trigger, unsigned int count); 

Find a timing line number. This function requires you to have captured data 
with the la_run("TIMING") function. See the Analyzing the Captured Data 
section of this manual for details on timing lines. 

Parameters: 

start Number (O-65535/OxO-OxFFFF) of the first timing line to search. 

dire Search direction: 

"FORWARD" Search forward. 

"BACKWARDS" Search backward. 

control A thirteen character string with characters 0,1,3,5,6,8,9,10, and 
12 corresponding to the SCSI BSY, SEL, ATN, REQ, ACK, C/D, 
I/O, MSG, and RST control signals, respectively. Each character 
specifies the required state of the corresponding signal: T 
(asserted), T' (deasserted to asserted transition), 'O' (deasserted), 
/ N' (asserted to deasserted transition) or 'X' (any state). 

data An eleven character string with characters 0,2,3,4,5,7,8,9, and 

10 corresponding to the SCSI DPO, D7, D6, D5, D4, D3, D2, Dl, 
and DO signals, respectively. Each character specifies the re¬ 
quired state of the corresponding signal: 'V (asserted), 'O' (deas¬ 
serted), or "X' (any state). 

trigger A one character string with "X", "x", or "1" specifying a search 

for the trigger line. 

count The number of occurrences (0-65535/OxO-0xFFFF) of timing lines 

of the type matching control, data, and trigger to find before 
returning the line number. 



Return Values: 

<0x8000 Successful execution. The exact value is the number of the 
specified state line. 

0x8040 Illegal data value. 

0x8041 Illegal trig value. 

0x8042 Illegal control value. 

0x8043 Illegal start value. 

0x8044 Illegal dire specifier. 

0x8050 Data not captured with la_run("TIMING"). 

OxFFFE Capture buffer is empty. 

OxFFFF Line specified by parameters not found. 
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unsigned long lat_line_data(unsigned int line); 

Get time line data and control signal values. This function requires you to 
have captured data with the la_run('TEvIING") function. See the Analyzing 
the Captured Data section of this manual for details on timing lines. 

Parameter: 

line The time line number whose data byte to return. 

Return Value: 

A 32-bit value. 

Bit pairs 30/31,28/29,26/27,24/25,22/23,20/21,18/19,16/17, and 14/15 
corresponding to the SCSI BSY, SEL, ATN, REQ, ACK, C/D, I/O, MSG, and 
RST signals, respectively. Bit pairs are interpreted as follows: 

msb lsb Interpretation 


1 0 Asserted 

1 1 Transition from asserted to deasserted 

0 0 Deasserted 

0 1 Transition from deasserted to asserted 

Bit 13 corresponds to the trigger and is 1 if the specified line is the trigger event; 
0 otherwise. 

Bits 8 to 0 correspond to the SCSI DPO and D7 to EX) lines, respectively. 1 is 
interpreted as asserted, and 0 as deasserted. 

Call the get_f_status("IO") function and interpret its return value as follows: 

0 Successful execution. 

0x41 Specified line not found. 

0x50 Data not captured with la_run( // TIMING"). 

OxFE Capture buffer is empty. 
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unsigned long lat_time_stamp(unsigned int line); 

Get tiie time stamp of a time line. This function requires you to have captured 
data with the la_nm("TIMING / ') function. See the Analyzing the Captured 
Data section of this manual for details on timing lines. 

Parameter; 

line The time line number whose time stamp to return. 

Return Value: 

The time stamp of the specified line in 100 nanosecond units. 

Call the get_f_status('TO") function and interpret its return value as follows: 

0 Successful execution. 

0x41 Specified line not found. 

0x50 Data not captured with la_nm('TIMIN G"). 

OxFE Capture buffer is empty. 
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unsigned int lat_trigger(char * control , char *data, unsigned int 
count f char *location ); 

Configure the SCSI bus trigger condition for subsequent data captures with the 
la_run( // TIMING ,, ) function. See the Trigger section of this manual for details. 

Parameters: 

control A thirteen character string with characters 0,1,3,5,6,8,9,10, 

and 12 corresponding to the SCSI BSY, SEL, ATN, REQ, ACK, 
C/D, I/O, MSG, and RST control signals, respectively. Each 
character specifies the required state of the corresponding 
signal: *Y (asserted), 'O' (deasserted), or 'X' (any state). 

Default: "XX XXX XXX X" 

data An eleven character string with characters 0,2,3,4,5,7,8,9, 

and 10 corresponding to the SCSI DPO, D7, D6, D5, D4, D3, 

D2, Dl, and DO signals, respectively. Each character specifies 
the required state of the corresponding signal: 'T (asserted), 

'O' (deasserted), or 'X' (any state). 

Default: "X XXXX XXXX" 

count The number of occurrences (O-65535/OxO-OxFFFF) of timing 

lines of the type matching control and data before triggering. 

Default: 1. 

location Location of Trigger writhin acquisition memory. 

"BEFORE" Acquire about 95% of data after the 

trigger. 

"CENTERED" Acquire 50% of data after the trigger. 
"AFTER" Acquire about 95% of data before the 

trigger. 

Default: "BEFORE" 

Return Values: 

OxFFFC Illegal location value. All parameters returned to default 
values. 

OxFFFD Illegal count value. All parameters returned to default values. 
OxFFFE Illegal data value. All parameters returned to default values. 

OxFFFF Illegal state value. All parameters returned to default values. 
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Appendix 



Troubleshooting 




I SCSI Hot Line 


If your problem is not included in the following descriptions, call 
our Development Systems Operation (DSO) hot line (Monday 
through Friday between 8:30 AM and 5:30 PM Pacific Coast Time): 

DSO Hot Line: (408)945-2527 


I Common 
Problems 


Symptom: 

The following message is displayed: 

*** CONFIGURATION ERROR *** 

No SCSI Bus Analyzer Detected 
Software Load Aborted 

Possible Causes: 

1. Analyzer PCB not installed. 

Install the analyzer PCB. See the Installing the Analyzer PCB 
section of this manual for details. 

2. Incorrect SBAADR DOS Environment variable value. 

Change SBAADR to the correct value. See the Configuring the DOS 
Environment With SDS310F section of this manual for details. 

3. Incorrect analyzer PCB I/O address setting. 

Set the correct address. See the Installing the Analyzer PCB section 
of this manual for details. 

4. Analyzer PCB installed in an 8-bit XT-compatible backplane slot. 

Re-install the analyzer PCB in a 16-bit AT-compatible slot. See the 
Installing the Analyzer PCB section of this manual for details. 
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Symptom: 

The following message is displayed: 

*** CANNOT FIND BIT FILES *** 

Software Load Aborted 

Possible Causes: 

1. Incorrect SB ADR V DOS Environment variable value. 

Change SBADRV to the correct value. See the Configuring the DOS 
Environment With SDS310F section of this manual for details. 

2. Incorrect software installation. 

Re-install the software. See the Installing the Software section of 
this manual for details. 

Symptom: 

One of the following messages is displayed: 

Cannot Allocate Memory for Control Variables 
Software Load Aborted 

or 

Insufficient Memory 

Possible Causes: 

1, Less than 640 KBytes memory installed in your computer. 
Increase memory to 640 KBytes. 

2. Terminate and stay resident (TSR) programs consuming too 
much memory. 

Remove all terminate and stay resident (TSR) programs from memory. 
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Symptom: 

Signal values are inverted in the timing display. 

Possible Cause: 

Incorrect configuration mode set. 

Change to the proper mode. If you are using the interactive menu, see the 
description of the ConfigMode command in the Interactive Menu 
chapter of this menu for details. If you are running a user test, see the 
description of the sba_config_mode function in the Run Time Function 
Library chapter of this manual for details. 
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Appendix 1 "% 


Specifications 



I Electrical 
Specifications 


• Analyzer PCB: 

Current: 3 amps typical, 5 amps maximum 
Voltage: 5.0 Vdc ±25 Vdc 

• Input channels: 

27 SCSI signals (BSY, SEL, ATN, REQ, ACK, C/D, I/O, MSG, RST, 
DPO, DPI, D0-D15): As defined in the SCSI-2 standard. 

4 external probe pod input signals (EXTO-3): Standard TTL. 

Resistor SIP RP1 pulls floating signals to an asserted state 
Voltage limitations: 0 Vdc to 5 Vdc 
Signal loading: One 74HCT load plus 20 pF 
Sample depth: 32K per channel 

• Output channel (TOUT): 

High-level source current: 3 mA 
Low-level sink current 24 mA 

• External probe pod ground (GND): Signal ground 


I Timing 
I Specifications 


• Sampling resolution: 20 nanoseconds (nsec) 

• Time stamp: 

Resolution: 20 nsec 

Time between rollovers: 122 hours 

• Minimum trigger event duration: 22 nsec 

• Minimum time between trigger occurrences: 40 nsec 

• External probe pod output assertion: Within 160 nsec of trigger 
assertion 

• External probe pod output deassertion: On capture data display or 
dear 


I Environmental 
Specifications 


• Operating temperature: 0°C (32°F) to 55°C (131 °F) 

• Non-operating temperature: -40°C (-40°F) to 75°C (167°F) 

• Humidity. 10% to 95%, noncondensing 


Physical 

Specifications 


• Shipping weight: 2 lbs 

• PCB: Standard full-size single-width AT form factor (13.25" x 4.75"). 

• External probe pod dimensions: 3.75" x 2.375" x .875" 

• SCSI 'F connector translator dimensions: 3"xl.5"x.7’ 
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Analyzer PCB 
68-pin ‘P’ 
Connector (J1) 


• Connector type: Nonshielded, high-density, 68-conductor 
connector consisting of two rows of 34 female contacts with 
adjacent contacts 1.27 mm (0.05") apart. 

• Pin outs: 


Pin 

Name 

Pin 

Name 

1 

Ground 

2 

D12 

3 

Ground 

4 

D13 

5 

Ground 

6 

D14 

7 

Ground 

8 

D15 

9 

Ground 

10 

DPI 

11 

Ground 

12 

DO 

13 

Ground 

14 

D1 

15 

Ground 

16 

D2 

17 

Ground 

18 

D3 

19 

Ground 

20 

D4 

21 

Ground 

22 

D5 

23 

Ground 

24 

D6 

25 

Ground 

26 

D7 

27 

Ground 

28 

DP0 

29 

Ground 

30 

Ground 

31 

Ground 

32 

Ground 

33 

Ground 

34 

Open 

35 

Open 

36 

Open 

37 

Ground 

38 

Open 

39 

Ground 

40 

Ground 

41 

Ground 

42 

ATN 

43 

Ground 

44 

Ground 

45 

Ground 

46 

BSY 

47 

Ground 

48 

ACK 

49 

Ground 

50 

RST 

51 

Ground - 

52 

MSG 

53 

Ground 

54 

SEL 

55 

Ground 

56 

C/D 

57 

Ground 

58 

REQ 

59 

Ground 

60 

I/O 

61 

Ground 

62 

D8 

63 

Ground 

64 

D9 

65 

Ground 

66 

D10 

67 

Ground 

68 

Dll 
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External Probe 
Pod 50-pin ‘A’ 
Connector 


Minimum 

Computer 

Requirements 


• Connector type: Nonshielded, low-density 50-conductor connec¬ 
tor consisting of two rows of 25 male pins with adjacent pins 2.54 
mm (0.1") apart. 

• Pin outs: 


Pin 

Name 

Pin 

Name 

1' ;•■■■ 

Ground 

2 

DO 

3 . , 

Ground 

4 

D1 

5 

Ground 

6 

D2 

7 

Ground 

8 

D3 

9 . 

Ground 

10 

D4 

11 

Ground 

12 

D5 

13 

Ground 

14 

D6 

15 

Ground 

16 

D7 

17 

Ground 

18 

DP0 

19 

Ground 

20 

Ground 

21 

Ground 

22 

Ground 

23 

Ground 

24 

Open 

25 

Open 

26 

Open 

27 

Ground 

28 

Open 

29 

Ground 

30 

Ground 

31 

Ground 

32 

ATN 

33 

Ground 

34 

Ground 

35 

Ground 

36 

BSY 

37 

Ground 

38 

ACK 

39 

Ground 

40 

RST 

41 

Ground 

42 

MSG 

43 

Ground 

44 

SEL 

45 

Ground 

46 

C/D 

47 

Ground 

48 

REQ 

49 

Ground 

50 

I/O 


• PC/AT-compatible 

• CGA video controller 

• 1286 CPU 

• 640 KBytes RAM 

• 360 KByte 5 1/4", 1.2 MByte 5 1/4”, or 1.44 MByte 31/2" floppy 
drive 

• Hard disk drive with at least 1 MByte available 

• 1,2, or 3 free backplane slots depending on your configuration. 

• One of the following hexadecimal I/O address ranges available: 
310-31F, 330-33F, 360-36F, 380-38F 

• DOS 3.0 
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